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“The StereoPi can capture, save, 
livestream, and process real-time 
stereoscopic video and images for 
robotics, AR/VR, computer vision, drone 
instrumentation, and panoramic video.” 
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Elettronica In 


RASPBERRY PI INSIDE 


MickMake 

“With it you can do things like, stream 
stereoscopic 3D video to YouTube, build 
real-time depth maps using OpenCV, 
create panoramics using Hugin and even 
a 3rd person view of real life. Cool.” 


@ Geeky Gadgets 


HOW ROBOTS SEE? 


StereoPi is an open source stereoscopic 
camera, based on Raspberry Pi. 


Raspbian 


STOCK RASPBIAN 
SUPPORT 


Raspberry Pi Blog 

“There are some excellent 
community efforts too, of 
which our current 
favourite is this nifty dual 
camera board.” 
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OPBENELECTRONICS 


This is the friendliest way to play with 
the stereoscopic vision for the spatially 
aware robots, 3D photo and video! 
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OPEN SOURCE 


CROWDFUNDED 
PROJECT 


Hackster News 

“You can hook this up to YouTube, 
to Oculus Go, you can use it with 
OpenCV.. | cannot wait to start 
messing around with these because 
it's basically a dream come true.” 
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pring is in the air. The British sun has got-his-hat-on at a 
jaunty angle and we’re looking forward to a summer of sunshine 
and outdoor activity. 
This issue we’re on our third ever #MonthOfMaking. Every March 
we throw off winter, dust off our tools, and encourage everyone to get 
making. It doesn’t matter what you plan: from the smallest mouse of a 
make to that massive computerised elephant of a project you’ve always 


Lucy 
Hattersley 


Lucy is editor of The 
MagPi and is building 


dreamed of. Now is the time to get started. car ci he 
Rob has a great feature for #MonthOfMaking (page 30) that covers E 

a range of crafting techniques. Discover a range of new materials to ae ae uieity 

bring to your build. Whether you’ re into woodworking, making with on pensively. 

metal, testing out textiles, or sticking to classics like plastic, cotton @Lucytiattersley 


and wool, there are tips for everybody. 
Of course, this being The MagPi, we like to feature Raspberry Pi 
at the heart of our builds. Last month we introduced Pico, the tiny 
microcontroller from Raspberry Pi. This month we’re looking at Easy CETA 
Pico Projects (page 64). We’re having a huge amount of fun testing Pico UWE aa) 
and thinking up all the things we ZERO W KIT 
can make with it. ERRY PI w 
Don’t forget to share your 
#MonthOfMaking projects with 
the rest of the community. We 
want to see what you build. Happy 
#MonthOfMaking! 
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Learn at Home 
programme continuing 
to provide computers 
to students 


Disadvantaged young people are being helped by the Raspberry Pi 
Foundation while they study at home. By Rob Zwetsloot 


What this does mean, though, is that many 

more children are now learning from home 
than they were last year, and may be for the rest 
of the school year. 

While some families may have the resources to 
allow for their children to continue schooling from 
home, some may not. 

“The closure of schools has called attention 
to the digital divide, which sees poorer families 
struggling or unable to access education,” the 
Raspberry Pi Foundation tells us. “The coronavirus 
pandemic didn’t cause this divide, but it has 
highlighted it and its impact on many people in 
our society. This has become significantly more 
urgent as a result of the pandemic and the ongoing 
disruption to schooling, which we know has a 
disproportionately negative impact on children 
who already experience disadvantage.” 


T he running of schools right now is in flux. 


Stay connected to school 

Ofcom estimates about two million children 
in the UK do not have access to a computer for 
learning from home. Some charities, and even 
the Department of Education, have stepped 
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up to allow for loaning laptops to students in 
need, and the Raspberry Pi Foundation is no 
different, donating computer kits to nearly 4000 
young people. 


m The Foundation's staff are 
also made available for 
ongoing tech support Ø 


“Since April 2020, we have partnered with 
a network of over 40 schools and youth and 
community organisations across the UK to 
get computers into the hands of nearly 4000 
disadvantaged young people that lack a computer 
to continue their school work,” the Foundation 
explains. “This work was generously funded by 
the Bloomfield Trust, S&P Global Foundation 
and more than 70 other generous individuals 
and companies.” 
Recipients are some of the more poorer 
families that don’t meet the requirement for the 
Department of Education’s loan initiative. These 
families also get support to get the computer 


MägPi 


The whole thing costs under £200 - here's what 
students are getting: 


Raspberry Pi 400 

Mouse 

HDMI cable 

Monitor 

USB webcam with microphone 
Headphones 

Power supplies 


Where the internet isn't available, the Raspberry Pi 
Foundation is helping to provide low-cost or free 
internet access, where possible. 


set up, and the Foundation’s staff are also made 
available for ongoing tech support. 


Computer kits are sent to Help is available for setting 
the recipients as part of up the computer with all 
Immediate impact the scheme the items in the pack 


For a program of this scale, the Foundation has 
made sure to get feedback where it can - from A 
surveys to feedback from partners — and so far it 

looks promising: 


Young people who previously weren’t engaged 
have begun engaging with learning. 

Parents have reported positive changes in young 
people’s attitudes and behaviour. 

Youth and social workers have deepened their 
relationship with families, enabling them to 
provide better overall support throughout 

this crisis. 


The program is ongoing throughout 2021. 
“Building on the success of our programme 
to date, we are now seeking more financial and 

practical support to help us achieve further 

impact at significant scale. If this is something 
you can support us with, please contact please 
contact us by visiting magpi.cc/learnathome.” 
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Philip Rueker 


Philip is a software 
engineer at 
Microsoft's 
Redmond, 
Washington 
headquarters. This 
is the first Raspberry 
Pi project he's 
designed and built 
from scratch. 


magpi.cc/ 
metarmap 


Warning! 
Weather warning 


Weather conditions 
can change abruptly, 
so consult detailed 
local forecasts before 
setting off for sky-bound 
adventures. 


magpi.cc/ 
aviationbriefing 


DP METAR data canbe 
pulled from a site such 
as aviationweather.gov, 
which uses familiar 
airport short codes. 
Write these codes 
on the back of your 
map when attaching 
your LEDs 
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jo METAR Map 


A colour-coded weather map provides an at-a-glance insight into whether 
it's good enough weather for flying, learns Rosie Hattersley 


fantasy for many of us. Such heroic, escapist 

dreams can be triggered by the sight of a small 
craft passing overhead. So it was for Austrian- 
born, US-based software engineer Philip Rueker. 
When leisure flights became a regular sight in his 
adoptive home of Redmond, Washington, Philip was 
thrilled enough to build his own aeroplane tracking 
tool. He’s now built a Raspberry Pi Zero-based 
METAR (meteorological aerodrome report) map on 
which colour-coded LEDs show the current flying 
conditions at local airports with a weather reporting 
station. Before flying an aeroplane, “you have to do 
some planning for the weather. Having a map on 
the wall to get a first glance indication of whether 
the weather is good today is a great start,” he says. 

Philip had long been fascinated “that a small, 

tiny Raspberry Pi is more powerful than the first 
full-size computer I sat in front of a long time ago 
when I was a child.” He also knew that Raspberry Pi 


| earning to fly your own plane is an idle 


© ia: AVIATION WEATHER CENTER 


would be very easy to use and set up, and expand its 
functionality over time. He decided on a Raspberry 
Pi Zero W since the program does not need a lot 

of power. He could connect to it over a wireless 
network to make changes to the code without 
having to plug it into the computer. He’s recently 
added a mini LED display to the setup. 


Plane spotting 
Philip’s previous projects include a PiAware 
aeroplane tracker which logs flights over his house 
and reports them to Flightradar24, along witha 
Raspberry Pi 3-based Stratux box which monitors 
nearby planes while you’re in the air. These gave 
him a great start when designing the METAR Map, 
for which he was mainly focused on developing his 
Python skills. 

Having seen the concept floated in a Reddit post, 
Philip and his partner — also a dedicated crafter and 
plane nerd - decided to work on it together. “It took 
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LEDs indicating airports and 
geographical features show 
at a glance whether each 
location is currently suitable 
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Weather stations at airports and other 
locations provide METAR data to assist 
aviators. Philip created Python code to pull 
in code from aviationweather.gov, while 
Raspberry Pi Zero W controls the LEDs 


Jado ame. | 
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Raspberry Pi Zero W's modest 
dimensions means it sits discreetly 
behind the METAR Map in its shadow 
box frame. Improvements to the 
setup can be provided wirelessly 


> Philip built an 
aeroplane tracker 
logging flights over 
his house.. 


> „which is full of Lego 
planes, rockets, 
and spaceships 


> He is a qualified 
private pilot.. 


> .and has been 
building his own 
plane in his garage 


> He hopes to pilot 
it one day! 
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A The addition of an LCD provides 
detailed airport weather information - 
useful for take-offs and landings 


V Testing the code ona string we P 3 n eee 
of LEDs before taping them a little bit of learning about language and piecing 


to back of the map together various libraries to make the lights, and 
everything come together,” he says. The project 
cost around $100, with the shadow box picture 
frame representing the biggest outlay. It would 
be perfectly possible to make your own frame, of 
course. The LEDs and Raspberry Pi Zero require 
little power, so the running costs are negligible. 
Philip wrote the code himself and is proud of 
the way he pieced the project together with eye- 
catching elements such as using the NeoPixe 
library to communicate with the LEDs, while 
keeping things simple so that others could build 
METAR maps of their own. Having posted the 
project on GitHub (magpi.cc/metarmapgit), 
Philip’s been delighted by the “awesome” METAR 
maps other people have created and has added 
functionality based on GitHub users’ requests. 
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@ Raspberry Pi’ (Pico) PA Components 


Extension Family 


Make Your Project Smarter With Pico’s Expansions DIY Kits 


Breadboard Kit GPIO Expansion HAT Expansion 
All in one Raspberry Pi Pico Raspberry Pi Pico GPIO Connects any 

kit with onboard LEDs, expander to access GPIO Raspberry Pi HAT with 
button, buzzer & breadboard pins easily. Raspberry Pi Pico. 


FOR MORE INFO, PLEASE VISIT : SHOP.SB-COMPONENTS.CO.UK 


Visit our online store 


Get started with Raspberry Pi, 
electronics, and more 


Be inspired by incredible 
projects made by other people 


Learn how to code and make 
with our step-by-step tutorials 


Find out about the top kits and 
accessories for your projects 
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A Inresponse to feedback 
by makers on GitHub, 
Philip added a lightning 
indicator and set LEDs to 
blink if a weather station 
is reporting high winds 


Refinements include making the lights blink 
if there are high winds at an airport, and another 
addition to make the LEDs flash white if there is a 
lightning storm in the area. He’s recently added a 
small LCD which shows full weather information 
for the airports. 


m Philip's been delighted by the awesome 
METAR maps other people have created m 


Mighty maps 

Although Philip created his METAR Map with 
aviation weather in mind, he says it could easily be 
adapted by someone who wanted to make a similar 
map to visualise the weather in nearby towns 

or cities. “All that would be needed would be an 
online source to get the weather data.” 

Fellow aviators have taken his project to heart. 
“Pve had quite a few pilots contact me who said 
they have never written any code [but who] were 
able to successfully put it all together and showed 
me their creations.” Hl 
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Make your own map 


Agreat project for Python coders, you'll need 
NeoPixels or WS2811 addressable LEDs, a detailed 
map, soldering iron, and a Raspberry Pi Zero W. Find 
Philip's GitHub at magpi.cc/metarmapgit. 


Lay out your map and identify cities, airports, 
and other locations you want to monitor. A 
comprehensive list of weather stations can be found 
at magpi.cc/aviationweather. 


fritzing 


Attach LEDs to Raspberry Pi Zero W and use 
the code on GitHub to match up lights with 
your chosen METAR locations. 


Test your lights, then tape everything to the back 
of your map (laminating or gluing it onto a board 
aids durability) and carefully place it in its frame. 
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AirMyPrayer 


Upgrading prayer reminders with new technology was a 
perfect job for Raspberry Pi, as Rob Zwetsloot finds out 


Abid Shah 


Abid has worked 

in IT for the last 21 
years. His hobbies 
include reading, 
helping with 
charitable works, 
freestyle wrestling, 
and working on the 
AirMyPrayer project. 


airmyprayer.co.uk 
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ith broadband internet available to 
W huge portions of the population, 

it’s easier than ever to connect to 
people remotely. The ubiquity of video calls and 
conferences means that you can have online 
gatherings like never before. For Abid Shah, 
this meant opening up places of worship to 
more people. 

“My project involves streaming live audio and 
video from houses of worship (actually from 
anywhere with internet) to social media platforms 
such as YouTube, Facebook and, more uniquely, 
straight to people’s homes,” Abid explains. 

“T have also designed and implemented an 
integrated prayer timetable.” 
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A The upgraded prayer timetable using a Raspberry Pi 


The prayer timetable is something Abid has 
been working on for about nine years, when 
he noticed people were ringing up their local 
mosque to check on any changes to prayer times, 
which could happen every week. “This had me 
thinking that we need a way for the prayer times 
to be accessible on a virtual platform for users,” 
he says. 


Virtual timetable 

Luckily, he was thinking about how to digitise 
the timetable at a very fortunate time. “After 
some research about what platform I could use to 
host such a project, the original Raspberry Pi was 
already on the market and seemed, in theory, to 
be the natural choice,” Abid recalls. “Possibly the 
only practical choice as there was nothing else in 
the market in my budget range.” 


m As the internet is more 
accessible now than 
the range of UHF radio 
transceivers, it was a logical 
way of upgrading these 
calls to prayer @ 


Using a client server setup, he was able to 
deliver a practical working example that is now 
being used in a several mosques. “To make it 
easier for the technophobes, I also have connected 
a Raspberry Pi to a smaller touchscreen monitor 
so one can easily change the congregational 
times,” he adds. 

The prayer timetable is only one part of the 
system - the other is a broadcasting system. 
“Mosques up and down the country traditionally 
have used UHF radio transceivers to transmit 
sermons or call to prayers to people’s homes,” 


DaKa 9 | 7 
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You can look in on the mosque 
via a camera to feel more 
connected to the community 


ee ST pe X 
Long waited re-esse part 7 of Mufti Abmad 


No live broadcast 
Aylesbury jamia Masjid Ghausia 
Manage from https://myairmasjid.airmyprayer.co.uk or 
http//192.168.1.13 


The prayer timetable is 
displayed on the screen 
and stays up-to-date 


Abid says. “Unlike experiencing the call to prayer 
in Islamic countries over the loudspeaker, the best 
alternative was to receive it through UHF radio 
receivers installed in homes.” 


Online solution 

As the internet is more accessible now than the 
range of these transceivers, it was a logical way of 
upgrading these calls to prayer. Abid got to work. 

“T came up with three key requirements,” he 
explains. The first is to deliver five times daily 
“a call to prayer and sermons/events to people’s 
homes using audio and/or video reliably without 
any user invention and fully automated. Secondly, 
it needs to be a budget system as we’re dealing 
with charitable organisations. Lastly, it needs to 
be portable so can be used in any organisation 
with internet availability.” 

The current AirMyPrayer system consists of a 
broadcasting Raspberry Pi at the mosque, which 
can use cameras or just a microphone, anda 
Raspberry Pi 4 that can receive the internet 
broadcast for people in their home. It uses a small 
touchscreen and is highly customisable - you can 


The home device 
can be plugged 
into a TV via HDMI 


even connect to it ona phone. Check the website 
for more details: airmyprayer.co.uk. 

Reception has been mixed - the older system 
has been in use for a long time, so changing toa 
new one has not been quick, according to Abid. 
“However, with incremental improvements to 
the design and a focus on a more friendly user 
experience, the device became more accepted, and 
now there are over 150 devices around my local 
area and still growing.” 


AirMyPrayer 


MéigPi 


A lot of trial-and- 
error and iteration 
occurred during the 
first two years 


Live streams can be 
accomplished with 
a phone camera 

as well 


Alerts can be sent 
to users from the 
‘managers’ of a 
connection 


Prayer is held five 
times a day 


The default home 
screen page 
includes local info, 
suchasa 

weather forecast 


Asimple mosque-side 
AirMyPrayer setup, 
which allows for 

voice transmission 
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ML-based Bird and 
Squirrel Detector 


Want to distinguish a bullfinch from a buzzard in your garden, or whether squirrels are up 
to no good? Machine learning has the answer. Nicola King takes a walk on the wild side 


ew York-based Mike Sadowski had “T have a Python program that runs on my 
N been interested in machine learning Raspberry Pi that watches a folder for new photos. If 
(ML) for some time and wanted some it sees one, it makes an API call to AWS to send the 
original images that he could feed into an ML photo to an AWS ‘bucket’,” Mike tells us. In AWS, he 
algorithm: “I was interested in the challenge has a Python Lambda function (a cost-effective way 
of trying ML with real data, not a canned data of running code) that watches the bucket, waiting for 
set,” he explains. photos. His Lambda takes the photo that just arrived 
Mike Sadowski One day, while looking out of his window, a flash and sends it to Amazon Rekognition, which then 
of inspiration came to him. “You really want a lot uses its ML-based image recognition capabilities to 
Mike is an IT of data for machine learning - the more the better. try to assess what the photo contains. 
executive with I was looking out the window at my bird feeder 
a real-estate and I realised that there were probably hundreds ø | was interested in the 
eee eka of birds visiting it daily, so that would be perfect! I 
hawas CTO attwo , added squirrels to the mix because they are always ch d | le nN g e of try| Nn g M L wit h 
venture-backed hanging around the feeder, hoping they can figure 
companies. On out how to break in.” real data, not a canned 
the side, he enjoys 
aa Eagle eye data set Ø 
machine learning. And so, Mike began work on his Bird and Squirrel 
magpi.cc/ Detector, a marvellous make that utilises a “Amazon Rekognition replies with a list of 
birdsquirrel Raspberry Pi, a High Quality Camera, some clever ‘labels’ (that’s a machine learning term that 


code, and Amazon Web Services image recognition describes what an ML algorithm thinks is in the 
(aka AWS Rekognition). Mike set his Raspberry Pi picture),” explains Mike. “Then my Lambda 


up to run PI-TIMOLO (magpi.cc/pitimologit), a code looks at the labels and decides if the image 
* tay erage nee downloadable software module that watches for contains a bird or squirrel. Based on this, it 
inspired his project motion and takes a snap when it detects any. sends a message to an AWS service called Simple 


Notification Service (SNS). You can subscribe to an 
SNS ‘topic’ and ask it to send you emails or texts. 
So I have one SNS topic for birds and another for 
squirrels, so I know what’s in each photo.” 


Winging it 

Mike had to tweak some of software parameters 
in order that the trigger to take the photo was just 
how he needed it. He wanted images of the birds 
and squirrels and not anything else. “You want 

to make sure you don’t miss good photos, but 

you don’t want to snap a picture every time a tree 
branch moves in the background, or yov’ll end up 
with thousands of photos per day.” 
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A High Quality Camera with 
a telephoto lens is pointed 
at the garden bird feeder 


_ 


PHILIPS 


The image is sent to the AWS Cloud, 
where Amazon Rekognition analyses 
it and generates a list of ID labels 


Running on a Raspberry Pi 4, 


PI-TIMOLO detects motion and pein Quick FACTS 
then captures an image 


A Ared-bellied woodpecker pays a visit to Mike's bird feeder. 
Standard AWS Rekognition identified it as a ‘woodpecker’ 


In addition, he says, “The other bit of fine- 
tuning that took some time was filtering out all 
of the uninteresting labels Amazon Rekognition 
returned. It tells you everything it thinks it sees 
in the picture. So it won’t just identify animals, it 
will also tell you it sees a bird feeder, or a chair. Or 
it might tell you it sees trees and grass, which may 
be accurate, but you don’t care about that.” So, he 
built up a list of ‘uninteresting’ labels over time, 
and filtered them out so he was only informed of 
bird and squirrel sightings. 

Mike describes the feedback he’s had from other 
makers as “amazing”, and is glad to share his 
insight into both the possibilities and limitations 
of Al. He’s also discovered the fantastic Raspberry 
Pi team spirit: “A cool thing about the Raspberry Pi 
community is that you can reach out to people and 
they will really help you.” Hi 


> The project took 
Mike several weeks 
(part-time) to 
complete 


> He plans to add 
another Raspberry 
Pi to create some 
squirrel deterrents! 


> Mike's GitHub 
code can be found 
here: magpi.cc/ 
birdsquirrelgit 


> If you want to have 
a go, you'll need 
Python skills... 


> „and a medium- 
level grasp of AWS 


The camera is pointed at 
the bird feeder. Mike started 
with a cheap telephoto 
lens, but switched to one 
borrowed from his Canon 
EOS camera 
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Raspberry P1 Amiga 600 


Billy Nesteroulis has created an Amiga computer 
for the modern user, as David Crookes explains 


Billy 
Nesteroulis 
(DJ Nest) 


Billy is an Amiga 
musician and a 
member of the 
Vintage Computers 
Society of Athens. 
His team specialises 
in 3D prints and he 
loves to experiment 
with Raspberry Pi. 


magpi.cc/djnest 


> With Amibian and 


Amiberry as the main 
emulator, you can 
emulate any Amiga 
model you like 
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ceased production in 1996 following a 
successful eleven-year run, many users 
remain determined to keep its memory alive. 
Not only has a new magazine recently emerged 
(Amiga Addict), but Commodore’s machine has 
resurfaced in various guises over the years. Its 
operating system, AmigaOS, continues to be 


E ven though the Amiga range of computers 


updated, and there are even rumours that a revived 


A500 model will be released this year. 


Such news excites Amiga fans. “The price of used 
Amigas has skyrocketed over the last five years and 


it’s not an easy task to preserve an old computer,” 
explains Billy Nesteroulis, aka DJ Nest. “If you 
own an old Amiga, it will eventually break: their 
electrolytic capacitors tend to leak. You’1l need 

a new power supply, and some kind of memory 
expansion is ideal.” 

With a Raspberry Pi computer, however, such 
costs can be significantly lowered. As Billy has 
shown, it’s possible to build an Amiga 600 from 
scratch with a Raspberry Pi 4 as the main unit. 


WV Anine-pin joystick from an original Amiga 
computer can be used with the USB adapter 
by Retronic Design (retronicdesign.com) 


“Raspberry Pi can emulate an Amiga with AmigaOS 
and you can use it to play games and software made 
for the machine,” he continues. 


Stars in their eyes 

Certainly, Raspberry Pi has proven to be the 
perfect platform for Amiga emulation. “Dimitris 
Panokostas has done a remarkable job creating 
the Amiberry emulator and because Raspberry 
Pi hardware is small, it can fit easily almost 
everywhere,” Billy says. 

In this instance, the single-board computer has 
been fitted inside a full-size, 3D-printed replica of 
an Amiga 600 case, allowing use of its USB ports 
and wireless LAN. A specially designed keyboard 
that was originally designed as a replacement for 
ageing Amiga machines is connected and modern 
adapters will allow use of the nine-pin joysticks of 
old for added authenticity. 

“The Cherry MX keyboard is illuminated and it 
was designed to fit the case that I 3D-printed,” 
Billy explains. “The joystick adapter is plug-and- 
play with no drivers needed and you can also use 
Amiga CD32 joypads with their eight buttons.” 
Other parts include a micro HDMI extender, SD 
card extender, power supply unit, USB extenders, a 
power switch, and LAN extender. 


The Cherry MX keyboard is specific and 
designed to fit the case. You have a choice 
of a black or white keyboard with standard 
white lighting or RGB 


{i l 


To ensure everything runs smoothly, Billy uses 
the Amibian distro (“the most complete experience 
of the classic Amiga environment”). He also 
likes that - in exchange for a small donation - he 
can use the Amibian 1.5 Extended Edition made 
by Gunnar Kristjánsson. “The Extended Edition 


Raspberry Pi can emulate 
an Amiga with AmigaOS 
and you can use it to play 
games and software 


includes Raspbian Buster V10 OS with the look and 
feel of the Amiga OS 4,” Billy says. “It has a modern 
browser, the VLC media player, and the Qmmp 
audio player. You can even use LibreOffice Writer.” 


A modern touch 

Amibian also allows users to update software and 
Amiga emulators through its configuration tool. 

All of which has meant Billy’s set up expands the 
potential of the machine, beyond matching the real 
A600. “It’s allowed me to bond classic computing 
with modern computing,” he says. 


pr g 


Raspberry Pi has been overclocked from 1.5GHz to 
2.1GHz, with the GPU running at 700MHz (up from 
500MHz). A CPU heatsink with a fan is also used 


W i 
2 


Indeed, Raspberry Pi 600 gives the same feeling 
and experience of the A600, but with the modern 
touch of the Raspberry Pi hardware. “It has the 
required juice to run specific software such the 
classic pixel-art package Deluxe Paint, games play 
without issues, and you can build your own system 
and adapt it to your needs,” Billy says. “For many 
people, it’s the best Amiga solution in 2021.” 


/ Pi Amiga 600 is the 
as the original A600 
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The files for the 3D-printed case 


were created by Jens Muhlenberg 
and cost $20 to download from 
magpi.cc/projjulia 


Amiga Pi 600 


The project costs 
around $250 in total 


It can emulate 
Amiga 500s to 
Amiga 4000s 


But the case is 
modelled on an 
Amiga 600 


You can plug it into 
a modern monitor 


Amiga novices 


could use the 
PiMIGA emulator 
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CNC 


plotter 


Recycling old tech to allow a computer to draw? Rob Zwetsloot checks out this amazing machine 


Stratos 
Botsaris 


A software engineer 
from Athens with 

an interest in DIY 
electronic projects 
using Raspberry Pi. 


magpi.cc/ 
cncplotter 


> The extra servo on top 
is to lift and lower the 
pen. With some string, 
of course 
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ne of the reasons we highlight cool 
0 projects is because we hope they inspire 

others. Stratos Botsaris is one of those 
people that got inspired. 

“T had seen people on the internet creating and 
using CNC plotters and always wondered how 
these machines work,” he explains. “I was mainly 
interested in way the CNC machine translates the 
G-code instructions into movement that drives the 
stepper motors. I wanted to find out the internal 
workings of this.” 

That’s just what he did, creating his own 
CNC plotter in the process. “It is controlled by 
Raspberry Pi and can draw an image on a surface 
the size of a piece of A4 paper,” he tells us. “I 
have designed and built both the hardware and the 
software myself. I have assembled its hardware 
by using recycled parts from an old scanner 
and a printer.” 


He also wrote the Python software which runs on 
Raspberry Pi. “It is an interpreter which reads and 
executes the G-code from a text file and drives the 
stepper motors.” 


Switching to Raspberry Pi 

According to Stratos, a lot of the projects he’d seen 
were made with Arduino, so he decided to see if it 
was possible with Raspberry Pi. 

“I started experimenting with one stepper motor 
with a Raspberry Pi,” he says. “Fortunately, I was 
lucky enough to have salvaged one stepper motor 
from an old printer and another one from an old 
scanner. In the beginning I had to find out how 
stepper motors work and how to connect one to 
Raspberry Pi. Then I tried to drive the stepper 
motor by writing a small program in Python and 
run it on Raspberry Pi. Once I managed to make 
this work, I got very excited and this gave me the 
push to continue with controlling two stepper 
motors at the same time. This was the most tricky 
part because I had to find a way to move the two 
stepper motors in parallel if I ever wanted the CNC 


A Lifting up the drawing surface reveals the old scanner 
parts below, as well as the platform's stepper motor 
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The pen is mounted to one 
stepper motor, while the other Stratos wanted to see if he could create 


moves the drawing surface f Sa . a plotter with Raspberry Pi after seeing 
many similar projects 


Quick FACTS 


> CNC stands 
for computer 
numerical control 


G-code is a set 


Y 


of instructions for 
This is part of an old scanner - a lot the CNC machine 


of the parts for this are recycled or interpreted from 
scavenged from old tech an image 


The motor that 
lowers and 
raises the pen is 
considered half 


v 


an axis 


v 


A stepper motor 
is used, as its 


plotter to draw a diagonal line. I had been trying Ø | had seen people on the moveméntis 
several algorithms in Python for a long time, but : : i performed in 
eventually the simplest one worked how I wanted.” internet creating and using CNC precise fractions 

of rotation 
Recycling to work plotters and always wondered 


v 


Stratos usually 


how these machines work Ø wanes lns 


The end result is a little robot that can draw - 
exactly as planned. You can see it in action on 
YouTube here: magpi.cc/cncplotdraw. 

We’re big fans of recycling and upcycling for 
projects here, and recycling was always part of 
Stratos’s plan. “I wanted to minimise the cost of 
the project as much as possible in order to find 
out how cheap it can be,” he says. “That is the 
reason that I reused parts from an old scanner 
and a printer for the hardware part. Also, I used 
L293D chips instead of the [more expensive] 
L298D motor driver board, so the only cost i 
was actually a Raspberry Pi and its accessories, ; / O TON 
which I owned anyway. - : 

“Moreover, I implemented the software program 
myself because I wanted to find out the internal 
working of a CNC plotter. So I would say the only 
thing that it cost me mainly was my time, which I 
enjoyed spending while doing this project!” H 


Talking about recycling old 
tech, an original Raspberry 
Pi Model B was used for 
the programming 
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RFID Gro Clock 


Live-wire toddlers are exhausting, with no concept of bedtime. A Raspberry Pi-based 
‘Gro Clock' signals when it's time to sleep, Sounds like bliss to Rosie Hattersley 


David Gardner 


David is an enterprise 
IT technician. He 
recently repaired 
several household 
electrical appliances, 
including a 1970s 
food mixer, a Kindle, 
and his Sonos audio 
streaming system (to 
which he eventually 
hopes to add 

more features). 


magpi.cc/ 
rfidgrowclockgit 


small children can be a challenge. David 

Gardner took a practical approach to sleep 
deprivation, devising a clock that uses a traffic 
light system to let the kids know when it’s OK 
to get up. The RFID Gro Clock is based around 
Raspberry Pi Zero W and has a custom-made 3D 
case. The project took about six weeks to complete, 
and was finished just in time for Christmas. 


G etting enough sleep when you’ve got 


Man with a plan 

The aim of David’s RFID Gro Clock project was “to 
get my son to be more independent in going to bed 
and then also to stay in bed longer in the morning. 
From a purely selfish point of view, that would give 
me a bit more time in bed,” he notes. 

To entice his three-year-old to go to bed in the 
first place, he decided to provide “some form of 
entertainment.” He also needed “a method to 
show somebody who cannot tell the time when it is 
OK to get up.” 


4. Interior of the RFID Gro Clock, showing 
Raspberry Pi Zero W and lighting all wired up 
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Story books that mentioned CDs piqued his son’s 
interest, so David decided this was a good option 
for the entertainment element. Using RFID as the 
control mechanism (for MP3s and other audio files) 
also made using the Gro Clock more intuitive: “I 
don’t like my children having lots of interactions 
with screens, so this is a great, physical way for 
kids to be able to control things.” 


Building blocks 

David based the project around Raspberry Pi 

Zero W for its GPIO programmability, memory, and 
microSD card support, as well as its compact size 
and low cost. He used Python to code everything and 
decided to use VLC Player for the MP3 playback, “as 
this has a pretty well-documented API and Python 
library, plus support for playing audio CDs.” 

He added a ‘setcd’ command to identify the 
number of tracks on a CD when it was inserted, and 
used events in his Python code to understand when 
the next or previous track was being played. 


P David used FreeCAD to design the 
3D-printed case for his Gro Clock 
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wospreusg ornp 


On-screen icons provide further 
indications of whether it's 
playtime or time for a nap. The 
clock will be handy once their 
toddler learns to tell the time 


Quick FACTS 


> David included a 
CD player after his 
son asked what a 
CD was 


v 


It's currently the 
family's only means 
of playing audio CDs 


7 u Z aH ists 


Y DAVID MCKEE 


A traffic light system indicates whether 
it's time to sleep, to read, or listen to > David's son refuses 
music in bed, or OK to get up and wake to use the RFID Gro 
the parents. Sneakily, the parents can Clock’'s alarm 

adjust the times and arrange a lie-in 


ACD player for audiobooks and music extends 
the Gro Clock’s usefulness. The large square 
buttons play, skip, pause, and replay tracks 


v 


But he enjoys the 
audio books (and 
outsmarting his 

dad, presumably) 


1 
y. ka 
/ > 


Y Testing the components 


w This iS (8) great, physical before installing them in the 


custom-designed case 


way for kids to be able to Pm 
control things @ 


David has since 
repaired several 
household items 
using his 
new-found 
electronics skills 


v 


He advises anyone planning a similar project to 
do their research and planning first. For example, 
he has no 3D printer, so used a 3D printing website. 
Having created a design in FreeCAD (using YouTube 


since 3D printing was already under way. 

“Raspberry Pi has been great for the project. It 
allowed me to have the flexibility of a computer 
and all the software packages that are available, 
whilst also giving me the ability to interface 
with a wide variety of electronics components,” 
he reveals. 

Because he was using existing components 
as far as possible, not everything came together 
immediately. The RFID element caused a few 
issues with power consumption due to the Python 
package chosen, and because it and the OLED 
connect via SPI. Nonetheless, David recommends 
RFID cards as a method of control. “It’s a great way 
to allow little people to interface with devices,” he 
says. “Maybe when [my son] gets a bit older and 
more into music, I may look to have some RFID 
cards play Spotify songs.” Hl 


videos as a guide) and sent the resulting STL file to a Bet 
print, David realised he’d omitted two (thankfully Wad NS Na 4S 
non-critical) items — a potentially pricey mistake wnijepe 

) p y pricey RL 4 
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Real-time bee monitor 


Researchers are buzzing with excitement after devising a low-cost 
method of monitoring wild bees, as David Crookes discovers 


cientists seeking to better understand 
S the ecology of bees know that monitoring 
them in the wild is no easy task. Harmonic 
radar — the best way of tracking bees — is expensive 
and complicated, which is why researchers are 
currently abuzz over a new method that puts a 
á Raspberry Pi computer at its heart. 


Michael Smith Led by computer scientist Michael Smith, a team 
of researchers from the University of Sheffield and 
Michaelis a The Bumblebee Conservation Trust have figured 


computer scientist 
at the University 
of Sheffield and 
the lead author of 
a study into the 
monitoring of bee 
species in the UK, 
using relatively 


a way to make the striped insects easier to spot. 
They’re dressing bees in hi-vis retroreflective 
vests and taking photographs of the environment, 
before subjecting them to a machine learning 
model that operates in real-time. 

“I was reading books by Dave Goulson, who 
described the problem of finding the nests of bees, 


inexpensive 

technology. and it got me thinking of ways to spot them from 
magpi.cc/ a distance without needing an electronic tag,” 
beetrack Michael tells us. 


“When I was cycling home one evening,” he 
continues, “ I noticed how retroreflectors are very 
noticeable when lit by the blinking bike light. It 
was a eureka moment.” 


Bee-hold Raspberry Pi 

Michael devised a method in which two 
photographs would be taken of an environment — 
one using a camera flash and the other without. 
He experimented by connecting a Raspberry Pi 3 


m Machine learning helps to remove false- 
positive spots caused by other objects Ø 


to an industrial global electronic-shutter camera, 
but soon switched up to a Raspberry Pi 4. “The 
better CPU meant we could process images much 
faster and the extra memory improves the image 
analysis as more images can be processed at once, 
he says. 


» 
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Y Study co-author Mike Livingstone is 
catching bees from the researchers’ 
nest in order to tag them 


The method depends on being able to take a 
flash photograph, so the camera needs to be able 
to expose the entire sensor at once, not just scan 
lines. “The very short exposure you can get with 
the electronic shutter (down to one microsecond) 
means I can match the exposure to the length 
of the flash, which is a few microseconds,” 
Michael reveals. “It means almost all of the 
illumination in the photo is from the flash, 
even on a bright sunny day, and so it’s easier to 
detect the retroreflector.” 


Hive of activity 

The machine learning process subtracts one photo 
from the other, leaving an image containing bright 
spots if the retroreflector-wearing bees happened 

to be in the frame. 

“Machine learning helps to remove false- 
positive spots caused by other objects such as 
moving trees and litter,” says Michael, who 
collected the machine learning data with two of 
his students — Isaac Hill and Chunyu Deng - by 
walking around in front of the tracking system 
with a reflector on the end of a stick. 
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A 


Two to four camera flashes 
(TT560 models by Neewer) 
are used. A Veroboard with 
mounted transistors allows 
the flashes to be triggered 

from the GPIO pins 


U a= À 


ee da 


Real-time data is provided via a 
webpage (and flask API) which is 
/ hosted on a Raspberry Pi 4 


Since the tracker works best when it's The £400 GCC2062M camera takes Quick FACTS 
looking down and is away from clutter, images which are then overlaid with the 


the scientists h imented with ; A JEN 
S SCOnS a NaNe QRPOUTENBO W bee's location, highlighted by a cross 


ways of getting the system in the air, > Retroreflective 

trying a hexacopter UAV, a 10 metre 

mast, and a tethered balloon tags are attached 

to bees 
“To build the system, we manually labelled 
p V The retroreflective tags placed on the > The tracker spots 

where our reflector was in the photos afterwards. bees are made of the same fabric as heseup teen 
These labels, combined with false-positive the high-visibility vests worn by cyclists metres away 
dots in the same images, were used to train 
the classifier, and we used Raspberry Pi OS, > It monitors foraging 
Python 3, standard libraries, and the Aravis d behaviour and 3D 
library to interface with the camera and process flight paths 


the results.” 

So far, the team has been able to detect bees 
from up to 40 metres away and this has thrown 
up some surprising results. On one occasion they 
found buff-tailed bumblebees up a pine tree some 
33 metres distant in a location the researchers 
wouldn’t have usually looked. 

“We’ve used the trackers in gardens, fields, 
and at various places on the university campus, 
but we’re in touch with other researchers who 
will be using them for looking at the initial flight 
of bees as they leave nests, or for monitoring 
bees foraging inside glass-houses. It also makes 
sense to think about tracking and detecting other 
insects. There are a lot of open research questions 
in behavioural entomology.” Hl 


> Seven species of 
wild bee have 
been monitored 


> Each tracker costs 
around £500 
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Try out other ways of making 
with #MonthOfMaking 2021 
and The MagP!! 


parts is the #MonthOfMaking, our month-long 
community building event. 

We love to seek out and showcase the amazing projects 
the wider Raspberry Pi and maker communities come up 
with - and by wider, we really mean wider. In the mag 
we often talk about electronic-based projects - we are 
a computer magazine, after all. However, the world of 
making encompasses much more than that: crafting, 
sewing, knitting, baking, sculpting, photography, 
model-making, cosplaying, and even more. 

While you can make anything you want for 
#MonthOfMaking, we want to highlight other ways you 
can make and be creative in this issue. Let’s build! 


I t’s that time of year again! March around these 
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The rules of #MonthOfMaking are simple 


Work on a project, 
new or old 


Take photos of 

your progress 

and completed 
projects 


The MagPi 79 


We introduced 
#MonthOfMaking in The 
9 with eleven 
projects you could try out 


magpi.cc/79 


č puio HACK CREATE HackSpace Magazine 


(Space 


+ MAK 
Our sister publication, 
HackSpace Magazine, 

is joining in on the 
#MonthOfMaking fun this 
year. Its back catalogue is 

a treasure trove of amazing 
project ideas and inspiration 


hsmag.cc 


Share it to Twitter 
and/or Instagram 
with a helpful 
description 


The MagPi 91 


He 


In The MagPi # 
showed you how to 


,we 


document and share your 
projects with the community 


magpi.cc/91 


TUTORIAL | 


Make sure to 
include the 
#MonthOfMaking 
hashtag 


#MonthOfMaking 
hashtag 


See what others are 

doi Be inspired by 
each other, and offer help 
if you can when asked 


MéigPi 


Craft 
making 


Sewing, knitting, crochet, weaving, 
etc. are some of the oldest 

forms of making. Here's how to 
Supercharge them with tech 


sually the closest we get to doing 
| j some kind of craft project with 
Raspberry Pi is with wearables. 
While they are cool in their own way, and can 
be definitely be part of this subject, we don’t 


do much that truly combines yarn craft and 
electronics. Here are some ways you can. 


magpi.cc/wearables 


We recently did a big feature on Arts and Crafts 
with Raspberry Pi, and you can find it in issue 
101 of The MagPi (magpi.cc/101) for more tips 
and inspiration. 


magpi.cc/socialwear 


32 magpi.cc #MonthOfMaking 


TUTORIAL | MägPi ME 


CNC Embroidery machine 


> This is a cool mixture of tech. A lot of 

© modern embroidery machines let you load up 
a pattern via a computer so that the end result 

is much more accurate and faster if you require it. 

This project is all about hacking a normal sewing 

machine that connects to a Raspberry Pi and some 

motors to do the hard work. It’s also a lot cheaper, if 

you have the skills, materials, and patience. 

This is a mix of hardware and software hacking 
and quite advanced. If you fancy doing some other 
kinds of upcycling/recycling, check over the page for 
other projects. 


magpi.cc/cncembroid 


ALTERNATE EMBROIDERY TIPS... 


Conductive 
threadembroidery 


Not sure if you want to hand-sew WEARABLE 
conductive thread into some fabric? TECH PROJECTS 
Want to try to hide it? This ingenious 

method of attaching conductive Our friends over at 
thread by wrapping it in thread also HackSpace Magazine 
allows the wire to be somewhat worked with the 
insulated! With some practice and a amazing Sophy Wong 
steady hand, you could possibly do to create a fantastic 
this with a normal sewing machine wearables book, full 
as well! of incredible ideas 


for merging tech 
magpi.cc/embroidery and fashion. Check 
it out at magpi.cc/ 


wearableprojects. 


Soft circuit button 


E2 This project is a little more of a hacky/DIY way 
Hat te work with fabric and electronics. Create a soft, 


safer button that can be used in a variety of wearable 


or other applications. It’s also fairly disguised for a button. 

There are also some good tips on how to use conductive 
thread in a sewing machine, such as lowering the tension 
on the machine. This project is based on Arduino, but it’s a 
perfect fit for Raspberry Pi Pico. 


magpi.cc/softbutton 
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Recycle 


1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
if 


Use old tech and unwanted 
household items and give 
them a new life 


Chandelier 
A 


EP aking can get expensive, but there’s 
so much you can do with old tech 
dia W aim or a cardboard box with a little 
ingenuity and elbow grease. Here are some 
great projects that might get you inspired to 
turn your Amazon box into a robot lawnmower. 


Recycled 
Robotic Arm 
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Upcycle 


Game Boy Zero 


Sticking a Raspberry Pi Zero 
Á í inside a classic game controller 
or handheld - or any old tech, 
for that matter - is a perfect fit for the 
tiny computer. While there are many 
Game Boy-style cases and 3D-printed 
builds you can do (and they’ll work very 
—_ nicely as well), this version uses an 
actual original Game Boy, albeit with 
some external modifications, like extra 
buttons taken from an NES controller. 
A cartridge has also been made into a 
giant microSD card adapter, so you can 
switch out cards easily. 


magpi.cc/gbzero 


AS 
fax 


AS 


Coffee Maker 
Greenhouse 


“A Is this an upcycle or a recycle? It’s probably closer 
to recycling as it doesn’t really work as originally 

intended, but it does use old tech in a new way. 
Either way, it’s very cool, as it’s been turned into an 
automated planter waterer using the original functions of 
the machine. 

The system can sense when the soil is dry, although 
currently it just waters on a timer. The brew button on the 
original chassis can be used to dispense water ahead of 
schedule as well, which is something we’d like to see more 
of in automated projects. 


magpi.cc/greencoffee 
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Google Pi 
Intercom 


It would be very easy 
oN to fill pages with 
upcycling projects 
from the always-inventive 
and creative Martin Mander. 
This Google Pi Intercom 
remains one of our favourites 
due to its mixture of old tech 
(an eighties office intercom) 
and new tech (Google voice 
assistant software). He made 
it using the Google AIY Voice Kit given away for free 
with issue 57 of The MagPi, but it doesn’t require that 
to make it work these days. 

You can find second-hand and broken tech on pretty 
much all good online auction/selling sites — just be 
sure you’ve fully discharged any capacitors before 
playing with it. 


magpi.cc/piintercom 
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Take photos with Raspberry Pi, 
and even do animation with it! 


Camera case hack 


vA 


T ™ hotography is an art and a science. 

| = Tweaking the settings of a camera 
E for that perfect composition goes 
hand in hand with creating excellent photos. 
You can do so much with a Raspberry Pi and a 
camera - whether you use an official Camera 
Module / High Quality Camera, a USB webcam, 
or a hacked DSLR. 


Make a 3D camer 


/camera 


A quick ar 


of the lines to make 
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FRAMES PER SECOND 


When creating an animation, ideally you want to aim for 24 
frames per second, which is the traditional frame rate of 
cinema. This is called ‘animating on ones’ That can be a lot of 
work, though, so some animators will skip a frame or three if it 
will save time. 


Frames per second | New picture every | Name 


24 Frame Ones 


6 Fourth frame Fours 


There are lots of other animation tricks, like moving backgrounds 
in parallax to get a sense of motion, or shining a light behind a 
picture with cut-outs to create an illusion of sparkles. 


Simple Raspberry 


Pi Camera Tra 
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Stop-motion 
animation 


site is very simple yet very effective, allowing 

you to take continuous shots using the press 
of a button before combining them all into one video 
at the end. There’s also a similar project in the Camera 
Guide. Creating sets and characters using the craft and 
recycling sections might be a great idea as well. 


This project from the Raspberry Pi Projects 
aS 


There’s a time-lapse photography project already 

in The Official Raspberry Pi Camera Guide. This 

particular setup takes it a step further, however, 
allowing for precise movement as part of the time lapse. 

It uses a mix of Arduino and Raspberry Pi, along with some 
clever code, to control a camera and motor to get a smooth 
pan-and-tilt effect on a time-lapse video. It should be easy 
to upgrade with the HQ Camera for more stunning shots. 


#MonthOfMaking | magpi.cc | 37 


CAL RASPBER 


cet started with 


MicroPython 


on Raspberry P | PICO 


tS 


Get started with 


MicroPython 


on Raspberry P1 Pico 


Learn how to use your new Raspberry Pi Pico 
microcontroller board and program it using 
MicroPython. Connect hardware to make your 
Pico interact with the world around it. Create 
your own electro-mechanical projects, whether 
for fun or to make your life easier. 


OFFICIAL 


RASPBERRY PI 


GUIDE 


© Set up your Raspberry Pi Pico ©® Control and sense 


and start using it electronic components 
© Start writing programs © Discover how to use Pico’s 
using MicroPython unique Programmable IO 


Available now: magpi.cc/picobook 
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Build a Pico 
Pomodoro timer 


Stay focused and get more done with help from 


Nik Rawlinson 


Esperanto- 
speaking, pencil- 
wielding, single- 
board computing 
fan who likes 
hyphens and 
remembers what 
that icon on the 
save button depicts. 


nikrawlinson.com 


| You'll Need 


> Pico Unicorn Pack 
magpi.cc/ 
picounicornpack 


> Pico Header Pack 
magpi.cc/ 
picoheaderpack 


> Soldering iron and 
solder 
magpi.cc/ 
solderingiron 


> Thonny IDE 
magpi.cc/thonny 


Raspberry Pi Pico and 112 colourful LEDs 


a tomato-shaped kitchen timer - has 

helped countless procrastinators get more 
done by breaking down jobs into 25-minute 
bursts, followed by five-minute rests. Although 
there are plenty of apps that will count down 
each work and rest cycle, picking up your phone 
to check how long remains can be a distraction in 
its own right. 

But pairing a Raspberry Pi Pico with the bright 
LEDs of a Unicorn Pack means you can see at a 
glance when your next break is approaching and, 
if you keep it just out of your eyeline, that warm 
red glow is a reminder to carry on working. 


T he Pomodoro Technique - named after 


Give your Pico some pins 

We want to attach Pico to a hardware array 
of LEDs - but, as Pico lacks the GPIO header of a 
regular Raspberry Pi, we’ll first need to solder a 
header to the long row of holes on either side of 
Pico itself. With the USB socket uppermost, fit 
Pico over the shorter pins on either header and use 
a small amount of solder on each one to create a 
contact with the corresponding metal strip on Pico. 
Don’t allow solder to stray across adjacent strips or 
pins, or you’ ll create a short circuit. 


Fit the Unicorn Pack 

When the solder has had time to cool, turn 
over Pico so that the longer end of each pin is 
pointing up and the USB socket is underneath. Now 
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A With the USB socket uppermost, the longer legs on your 
soldered headers should point downwards 


check the back of the Unicorn Pack, where you’ ll 
see there’s a white painted illustration of Pico’s 
USB socket. Line up this illustration with the actual 
USB socket, then press the Unicorn Pack onto the 
header pins on Pico. Be firm but gentle, and try to 
keep equal pressure on either end to reduce the 
risk of bending any pins on either of the headers. 


Flash Pico 

Your Pico contains a web link to Raspberry 
Pi’s own firmware, but this doesn’t include the 
additional hooks required to work with the Unicorn 
Pack. Instead, you need Pimoroni’s custom 
MicroPython firmware image. Point your browser 
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Press X to start a work cycle 
and Y to terminate the process 


The LEDs are extinguished at different 
rates for the work and rest cycles 


at magpi.cc/pimoronipicoreleases and download 
the most recent UF2 (.uf2) file - examples for use 
are at magpi.cc/pimoronipicogit. Press and hold 
Pico’s BOOTSEL button while plugging it intoa 
USB port on your computer (Raspberry Pi, PC, or 
Mac). When it appears, drag the UF2 file from your 
Downloads folder onto Pico. It will then reboot 
with the updated firmware. 


m We'll code Pico using 
Thonny, which is included in 
Raspberry Pi OS D 


Redirect Thonny 

We’ll code Pico using the Thonny Python 
IDE, which is included in Raspberry Pi OS, and free 
for Windows and macOS (thonny.org). By default, 
it works with and executes code stored locally, but 
we want to address Pico directly so that we can take 
advantage of the custom firmware. Click ‘Python’ 
in the lower-right corner of the Thonny window 
and select ‘MicroPython (Raspberry Pi Pico)’ from 
the list of options to redirect its output - you’re 
now ready to start coding. Make sure you save your 
code regularly as main.py and, when asked where 
you want to save, choose ‘Raspberry Pi Pico’. 


Set up the environment 

The first three lines of code set up the 
environment in which our program will run by 
referencing the libraries that handle time and 
the specific features of our Unicorn Pack add-on. 
We’ll use the utime library to count the length of 
each work and rest cycle - which are 25 minutes 
(1500 seconds) and five minutes (300 seconds) 
respectively — and divide the number of seconds in 
each stretch by 112. Then, every time one 112th of 
a cycle has passed — 13.4 seconds on a work cycle 
and 2.7 on a rest cycle — we’ ll extinguish one of the 
LEDs on the Unicorn Pack. 


4d When fitting the 


Unicorn Pack to 
Pico, match the rear 
illustration to the 
USB socket to make 
sure it's correctly 
orientated 


TopTip è 


Why main.py? 


You can save 
multiple apps 

on your Pico, but 
only main.py runs 
automatically 
when it’s 
powered up. 
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Warning! 
Soldering 


This project requires 
soldering. Take care 
when handling a hot 
soldering iron and solder. 


magpi.cc/soldering 


TopTip è 


Button 
bonanza 


We're using two 
buttons, leaving 
two free. You 
could program 
one to skip to 
the rest cycle for 
comfort breaks. 


Define a new process 

We’ll define a process that can be kicked 
into action as soon as the X button is pressed. 
We’ve called this process pomocycle, as detailed 
on line 7. The first job is to define the variables 
we’ll be using, which include values for the red and 
green mix in the colours we want to display (red for 
work, green for rest), and a column and row count. 
Why 6 and 15 when there are 7 rows of 16 LEDs on 
the Unicorn Pack? Because the first row and first 
column of each is counted as 0, not 1. 


m The important element 
here is the multiplier @ 


07 Build them up... 

We now start a loop that keeps running as 
long as button Y hasn’t been pressed. If it has, we 
exit the process and go back to waiting for a press 
of the X button, which starts the work and rest 
cycles all over again. The first job is to illuminate 
every LED on the Unicorn Pack, so we work through 
a couple of cycles, one of which is embedded within 
the other so they can target each pixel directly and 
set it to either red or green, depending on whether 
we’re working or resting, as defined in both the 
opening variables and the reset cycles that appear 
later in the code. 
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4d When first 
connecting Pico 
to your computer, 
hold the BOOTSEL 
button to mount 
the file system so 
you can transfer the 
necessary firmware 


08 „and knock them down 

Now we start extinguishing the LEDs 

one by one. The important element here is the 
multiplier, which defines how long Pico will wait 
after turning off a light before targeting the next 
one. We could have told it to wait 13.4 seconds 
between each action in a work cycle, or 2.7 
seconds in a rest cycle. If we did that, however, 
it would only be possible to interrupt a cycle by 
pressing Y every 13.4 or 2.7 seconds, which would 
both feel very unresponsive, and be extremely 
irritating. We need to find a way of checking the 
button’s status during a sleep cycle. 


Wake, sleep, repeat 

The solution is to only sleep for 0.1 seconds 
before checking the status of the button, and 
to use the multiplier to define how many times 
the sleep/check cycle is repeated. By repeating 
it 134 times for each LED when working, it will 
take 1500.8 seconds to extinguish all of the LEDs. 
Conveniently, that’s 0.8 seconds longer than 
a 25-minute work cycle. On a rest cycle, we set 
the multiplier to 27, so the sleep/check process 
loops 27 times for each LED, the last of which will 
then extinguish after 302.4 seconds, which is five 
minutes and 2.4 seconds. 


A Make sure you select the ‘'MicroPython (Raspberry Pi Pico)’ 
interpreter when working with code in Thonny 


Subtract and start again 

Every time an LED is extinguished, we 
subtract one from the column count and, when 
the next loop repeats, the LED in that spot will go 
out. Remember, the first column is column zero, 
so when the column count number hits -1 we reset 
the counter to 15, and instead subtract one from 
the row count. This continues until the row counter 
also hits -1, when we know there are no remaining 
illuminated LEDs. At this point, if we’ve been ona 
25-minute work cycle, we need to switch to a five- 
minute rest cycle, and vice versa. 


main.py 
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DOWNLOAD 
THE FULL CODE: 


Reset the variables 

If we were working, it’s time to rest. So, we 
set the multiplier to 27 and swap the values for 
the red and green tones we’ll use to illuminate the 
LEDs. Then, when the process restarts, the LEDs 
will shine green and blink out more quickly as 
they count to the end of our break. If we had been 
resting, the LEDs are instead set to red, and the 
multiplier is again set to 134 to slow down the rate 
at which they disappear. The code now rewinds 
the defined process, illuminates each LED as 
appropriate, and starts the next countdown. 


Keep everything running 

At this point, our code is all but complete. 
We just need to define what happens when we 
press the Y button. That’s handled in lines 53 to 
55, which simply extinguish any remaining LEDs 
on the Unicorn Pack by setting the red, green, and 
blue value for each one to zero. Then, the code 
comes to an end. With nothing else to do, Pico 
returns to where it started, waiting for the next 
time the X button is pressed, at which point the 
pomocycle process kicks into action once again. [7 


> Language: MicroPython 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 
012. 
013.: 
014. 
9015. 
016. 
017. 
018. 
019. 
020. 
021. 
022. 
023. 
024. 
025. 
026. 
027. 
028. 
029. 


030. 
031. 
032. 
033.: 
034. 
9035. 
036. 
037. 
038. 
039. 
040. 
041. 
042. 
043. 
044. 
045. 
046. 
047. 
048. 
049. 
050. 
051. 
052. 
053. 
054. 
9055. 
056. 
Q57. 
058. 
059. 


© magpi.cc/picopomodorogit 


import math 
import utime 
import picounicorn 


picounicorn.init() 
def pomocycle(): 


# Set up our variables 
r = 255 

g=0 

column = 15 

row = 6 

phase = "work" 
multiplier = 134 


# Start counting down 
while not(picounicorn.is_pressed(picounicorn.BUTTON_Y)): 


# Illuminate every LED on the board 
for x in range(16): 
for y in range(7): 
picounicorn.set_pixel(x, y, r, g, ®) 


# Extinguish LEDs one by one 
while row > -1: 
while column > -1: 
for x in range(multiplier): 
if not(picounicorn.is_pressed( 
picounicorn.BUTTON_Y)): 
utime.sleep(@.1) 
else: 
break 
picounicorn.set_pixel(column, row, ©, ©, @) 
column -= 1 
column = 15 
row -= 1 
row = 6 


# No more LEDs? Switch from work to rest and vice versa 

if phase == "work": 
phase = "rest" 
multiplier = 27 
r=0 
g = 255 

elif phase == "rest": 
phase = "work" 
multiplier = 134 
r = 255 
g=0 

pass 


# Clear the display 
for x in range(16): 
for y in range(7): 
picounicorn.set_pixel(x, y, ð, ©, @) 


while True: 
while picounicorn.is_pressed(picounicorn.BUTTON_X): 
pomocycle() 
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Create GUIs 
with Python: 
Meme Generator 


Create a GUI application which draws memes 


previous instalments to create a GUI which 

draws memes. You will input the text and 
image name and your GUI will combine them into 
your own meme using the Drawing widget. 

Start by creating a simple GUI with two text 
boxes for the top and bottom text. This is where 
you will enter the text which will be inserted over 
your picture to create your meme. Add this line to 
import the widgets needed. 


| et’s take the lessons you learnt from the 


from guizero import App, TextBox, Drawing 
Then add this code for the app: 
app = App("meme") 


top_text = TextBox(app, "top text") 
bottom_text = TextBox(app, "bottom text") 


app.display() 


The meme will be created on a Drawing widget 
which will hold the image and text. 


Create a meme 

Add it to the GUI by inserting this code just before 
the app.display() line. The Drawing widget’ s 
height and width should be set to ‘fill’ the rest of 
the GUI. 


meme = Drawing(app, width="fill", 
height="fill") 
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The meme will be created when the text in the top 
and bottom text boxes changes. To do that, we will 
need to create a function which draws the meme. 

The function should clear the drawing, create an 
image (we’re using a photo of a woodpecker, but 
you can use any you want) and insert the text at 
the top and bottom of the image. 

Remember when you used name. value to set 
the value of the Text widget with the spy name in 
Part 2 of this series? You can also use the value 
property to get the value of a Text widget, so in 
this case top_text.value means ‘please get the 
value that is typed in the top_text box’. 


def draw_meme(): 
meme.clear() 
meme.image(@, ©, "“woodpecker.png") 
meme.text(20, 20, top_text.value) 
meme.text(20, 320, bottom_text.value) 


The first two numbers in meme. image(@, ©) and 
meme.text(2@, 20) are the x, y co-ordinates of 
where to draw the image and text. The image is 
drawn at position @, ©, which is the top-left corner, 
so the image covers the whole of the drawing. 

Finally, call your draw_meme function just before 
you display the app. Insert this code just before 
the app.display line: 


draw_meme() 


Your code should now look like memet1.py. 
If you run your app (Figure 1) and try changing 


Figure 1 DEDE 


top text 
bottom text 


A Figure 1 Meme with unstyled text 


the top and bottom text, you will notice that it 
doesn’t update in the meme. To get this working, 
you will have to change your program to call the 
draw_meme function when the text changes, by 
adding a command to the two TextBox widgets to 
the app. 


top_text = TextBox(app, "top text", 
command=draw_meme) 

bottom_text = TextBox(app, "bottom text", 
command=draw_meme) 


™ Update your meme by 
changing the top and 
bottom text Ø 


Your code should now look like that in memez2.py. 
Run it and update your meme by changing the top 
and bottom text. 

You can alter the look of your meme by 
changing the color, size, and font parameters of 
the text. For example: 


meme.text( 
20, 20, top_text.value, 
color="orange", 
size=40, 
font="courier" 
meme. text ( 
20, 320, bottom_text.value, 


TUTORIAL | MägPi ME 


meme1.py 


DOWNLOAD 
THE FULL CODE: 


> Language: Python 3 


© magpi.cc/guizerocode 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
0190. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 
020. 
021. 
022. 
023. 
024. 
025. 
026. 


# Imports --------------- 


from guizero import App, TextBox, Drawing 


# Functions ------------- 


def draw_meme(): 
meme. clear() 


meme.image(®, ©, "woodpecker .png") 
meme.text(20, 20, top_text.value) 
meme.text(20, 320, bottom_text.value) 


app = App("meme") 


top_text = TextBox(app, “top text") 
bottom_text = TextBox(app, "bottom text") 


meme = Drawing(app, width="fill", height="fill") 


draw_meme() 


app.display() 


memedz2.py 


> Language: Python 3 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 
020. 
021. 
022. 
023. 
024. 
025. 
026. 


# Imports --------------- 


from guizero import App, TextBox, Drawing 


# Functions. ------------- 


def draw_meme(): 
meme.clear() 


meme.image(@, ©, "woodpecker .png") 
meme.text(20, 20, top_text.value) 
meme.text(20, 320, bottom_text.value) 


app = App("meme") 


top_text = TextBox(app, “top text", command=draw_meme) 
bottom_text = TextBox(app, “bottom text", command=draw_meme) 


meme = Drawing(app, width="fill", height="fill") 


draw_meme() 


app.display() 
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TopTip è 


These lines ) 
of code were 
starting to get 
very long, so we 
have split them 
over a number 
of lines to make 
it easier to 
read. It doesn't 
affect what the 
program does, 
just how it looks 


color="blue", 
size=28, 
font="times new roman", 


Your code should now look like meme3.py. Try 
different styles until you find something you 
like (Figure 2). 


Customise your meme generator 

For a truly interactive meme generator, the user 
should be able to set the font, size, and colour 
themselves. You can provide additional widgets 
on the GUI to allow them to do this. 


memes.py 


> Language: Python 3 


001. 
002. 
0903. 
004. 
0905. 
006. 
007. 
008. 
0909. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 
020. 
021. 
022. 
023. 
024. 
025. 
026. 
027. 
028. 
029. 
030. 
031. 
032. 
033. 
034. 
035. 


# Imports --------------- 


from guizero import App, TextBox, Drawing 


# Functions ------------- 


def draw_meme(): 
meme.clear() 
meme.image(ð, ©, "woodpecker .png") 
meme. text( 
20, 20, top_text.value, 
color="orange", 
size=40, 
font="courier") 
meme. text( 
20, 320, bottom_text.value, 
color="blue", 
size=28, 
font="times new roman", 


app = App("meme") 


top_text = TextBox(app, “top text", command=draw_meme) 
bottom_text = TextBox(app, “bottom text", command=draw_meme) 


meme = Drawing(app, width="fill", height="fil1") 
draw_meme() 


app.display() 
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The number of options available for the colour 
and font are limited, so you could use a drop- 
down list, also known as a Combo, for this. The 
size could be set using a Slider widget. 

First, modify your import statement to include 
the Combo and Slider widgets. 


from guizero import App, TextBox, Drawing, 
Combo, Slider 


After you have created your TextBox widgets for 
the top and bottom text, create a new Combo 
widget so the user can select a colour. 


bottom_text = TextBox(app, "bottom text", 
command=draw_meme) 
color = Combo(app, 
options=["black", "white", "red", 
"green", "blue", "orange"], 
command=draw_meme) 


The options parameter sets what colours the user 
can select from the Combo. Each colour is an 
element in a list. You can add any other colours 
you want to the list. 


m The options are 
displayed in the order in 
which you put them 

in the list @ 


The options are displayed in the order in which 
you put them in the list. The first option is the 
default, which is displayed first. If you want to 
have a different option as the default, you can do 
it using the selected parameter, e.g. "blue". 


color = Combo(app, 
options=["black", "white", "red", 
"green", "blue", "orange"], 
command=draw_meme, 
selected="blue") 


Now your user can select a colour. Next, you need 
to change the draw_meme function to use Combo’s 
value when creating the text in your the meme. 
For example: 


Figure 2 mene 


UI, no thanks 


A Figure 2 Alter the fonts and colours 


meme. text ( 
20, 20, top_text.value, 
color=color.value, 
size=40, 
font="courier") 


Do the same for the bottom-text block of code. 
Your program should now resemble meme4.py. 

Following the steps above, add a second Combo 
to your application so the user can select a font 
from this list of options: ["times new roman", 
"verdana", "courier", "impact"]. Remember to 
change the draw_meme function to use the font 
value when adding the text. 

Create a new Slider widget to set the size of the 
text your user wants. 


size = Slider(app, start=20, end=40, 
command=draw_meme) 


The range of the slider is set using the start and 

end parameters. So, in this example, the smallest 

text available will be 20 and the largest 40. 
Modify the draw_meme function to use the 

value from your size slider when creating the 

meme’s text. 


meme.text( 
20, 20, top_text.value, 
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meme4.py 


> Language: Python 3 


001. 
002. 
003. 
004. 
0905. 
006. 
007. 
008. 
0909. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 
020. 
021. 
022. 
023. 
024. 
025. 
026. 
027. 
028. 
029. 
030. 
031. 
032. 


033. 
034. 
035. 
036. 
037. 
038. 
039. 


# Imports --------------- 


from guizero import App, TextBox, Drawing, Combo, Slider 


# Functions ------------- 


def draw_meme(): 
meme. clear() 
meme.image(@, ð, “woodpecker.png") 
meme. text ( 
20, 20, top_text.value, 
color=color.value, 
size=4e, 
font="courier") 
meme. text ( 
20, 320, bottom_text.value, 
color=color.value, 
size=28, 
font="times new roman", 


app = App("meme") 


top_text = TextBox(app, “top text", command=draw_meme) 
bottom_text = TextBox(app, “bottom text", command=draw_meme) 


color = Combo(app, 

options=["black", "white", "red", "green", 
"blue", "orange"], 

command=draw_meme, selected="blue") 
meme = Drawing(app, width="fill", height="fi11") 


draw_meme() 


app.display() 


Drawing widget 


The Drawing widget is really versatile and can 

be used to display lots of different shapes, 

patterns, and images. To find out more about 

the Drawing widget, see Appendix C of the book 
(magpi.cc/pythongui), or take a look at the online 
documentation: lawsie.github.io/ guizero/drawing. 
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04-meme-generator.py 


> Language: Python 3 


001. # Imports --------------- 


002. 

003. from guizero import App, TextBox, Drawing, Combo, Slider 
004. 

005. 

006. # Functions ------------- 

007. 

008. def draw_meme(): 

009. meme.clear() 

010. meme.image(ð, ©, "woodpecker .png") 
011. meme. text( 

012. 20, 20, top_text.value, 
013. color=color.value, 

014. size=size.value, 

015. font=font.value) 

016. meme. text ( 

017. 20, 320, bottom_text.value, 
018. color=color.value, 

019. size=size.value, 

020. font=font.value, 

021. ) 

022. 

023. 

024; # App ------------------- 

025. 

026. app = App("meme") 

027. 


028. top_text = TextBox(app, “top text", command=draw_meme) 
029. bottom text = TextBox(app, “bottom text", command=draw_meme) 


030. 

031. color = Combo(app, 

032. options=["black", "white", "red", "green", 
"blue", "orange"], 

033. command=draw_meme, selected="blue") 

034. 

035. font = Combo(app, 

036. options=["times new roman", "verdana", "courier", 
"impact"], 

037. command=draw_meme) 

038. 

039. size = Slider(app, start=20, end=5@, command=draw_meme) 

040. 

041. meme = Drawing(app, width="fill", height="fill") 

042. 

043. draw_meme() 

044. 


045. app.display() 


Figure 3 mEnE SENEN 


A Figure 3 The finished meme generator 


color=color.value, 
size=size.value, 
font=font.value) 


Your code should now resemble that in 
04-meme-generator.py. Try running it and you 
should see something like Figure 3. 

Can you change the GUI so that the name of 
the image file can be entered into a TextBox 
or perhaps selected from a list in a Combo? 
This would make your application capable of 
generating memes with different images too. M 


Create Graphical User 
Interfaces with Python 


For further tutorials on how 
to make your own GUIs with 
guizero, take a look at our 
book, Create Graphical User 
Interfaces with Python. Its 
156 pages are packed with 
essential info and a range of 
exciting projects. 
magpi.cc/pythongui 
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y 


Create Graphical 


User Interfaces 
with Python 


Create games and fun Python programs 


Learn how to create your own graphical 
user interfaces 


Use windows, text boxes, buttons, 
images, and more 


Learn about event-based programming 


Explore good (and bad) user 
interface design 


Create Graphical User 
B interfaces with Python 


How to build windows, buttons, and widgets 
for your Python projects 
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Make a digital 


do-not-disturb sign 


Kids barging in on Zoom meetings? Parents being a pain when you're in Google Classroom? 
Let them know what you're up to with ‘Busybot', the custom do-not-disturb sign 


PJ Evans 


PJ is a writer, tinkerer, 
and software 
engineer. He spends 
all day on Zoom and 
no longer knows if 
his colleagues have 
legs or not. 


@mrpjevans 


| You'll Need 


> 2 x Raspberry Pi 
Zero W 
magpi.cc/pizerow 


> Scroll pHAT HD 
magpi.cc/ 
scrollhathd 


> PHAT Diffuser 
magpi.cc/ 
phatdiffuser 


> Keybow kit (3-key) 
magpi.cc/keybow3 


here are often times when family and 
T work life collide. The internet is littered 

with videos of online meetings being 
hijacked by partners, parents, and pets. We can’t 
do anything about your cat, but maybe a digital 
sign can let people know what you’re up to, and 
whether it’s OK to wander in. 

In this tutorial we’re going to use a popular 
messaging protocol, MQTT (Message Queuing 
Telemetry Transport). With MQTT, we will set up 
a simple do-not-disturb sign that you can trigger 
with a single key press and customise to your 
heart’s content. 


Prepare Raspberry Pi 

We’re using two Raspberry Pi Zero W 
computers for this project, although it will 
work with any recent model. For both, we 
recommend installing Raspberry Pi OS Lite 
(magpi.cc/software) as we don’t need a desktop 
interface. Make sure both devices are working 
and connected to the same network. We also 
recommend setting their host names by running 
sudo raspi-config at the command line, then 
going to System Options > Hostname. We chose 
‘busybot’ for the sign and ‘buttonbot’ for the 
controller, and that’s how we’ll refer to them 
throughout this tutorial. Finally, make sure 
everything is up to date. Enter these commands: 


sudo apt update 
sudo apt full-upgrade 


You should be able to ping one device from the 
other. On ‘busybot’ Raspberry Pi Zero W, enter: 


ping buttonbot.local 


You should get a response from ‘buttonbot’ 
Raspberry Pi Zero W. 
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Install the Scroll pHAT HD 

and diffuser 
We’re going to set up the display first. Pimoroni’s 
Scroll pHAT HD is a display made up of 17*7 pixels 
(119 total) and comes with a Python library that 
does all the hard work of displaying and scrolling 
text for us. The pHAT form factor makes it just the 
right size for a display, but of course you can adapt 
this tutorial to any display you like. You’1l need to 
solder the 40-pin header to the display and also add 
a reciprocal header to ‘busybot’ Raspberry Pi if it 
doesn’t already have one. Before assembling them 
together, screw on the diffuser, which will make the 
display much easier to read. Now, with Raspberry Pi 
powered off, carefully connect the Scroll pHAT HD. 


Set up the display software 

It’s time to make sure our display is 
working before we go any further. Fortunately, 
Pimoroni has created an install script for us. At the 
command line, run the following: 


curl https://get.pimoroni.com/scrollphathd 
| bash 


Make sure you do the ‘Full Install’ when the option 
is presented. This will set up Raspberry Pi so it 
can communicate with the display and install 
all the Python libraries we need. Take a look at 
Pimoroni’s GitHub (magpi.cc/scrollphatgit) for 
more information on installation. 

Once the install has finished, we can test things 
out. Reboot, then try this on the command line: 


cd ~/Pimoroni/scrollphathd/examples 
python3 swirl.py 


See a pretty pattern? Then you’re ready to proceed. 
Have fun with the other examples in the directory; 
they’ re a great source of inspiration. 


“a 
These bright LEDs can produce 


scrolling text or patterns 


a 


The interface 

Our buttonbot and busybot are going to need 
to talk to each other over the network. One of the 
easiest, and most popular, ways to do this is the 
MOTT protocol. It uses a pub/sub model (publisher 
/ subscriber) to process messages. An MQTT server 
(the ‘broker’) receives messages from ‘publishers’ 
that are then transmitted to ‘subscribers’. These 
are organised by ‘topic’. The biggest advantage is 
that publishers don’t need to understand or even 
be aware of the subscribers, they just need to speak 
MOTT. Don’t worry if this is confusing, working 
through the tutorial will make things clearer. 


Mosquitto 

For our system to work, you need an MQTT 
server (or ‘broker’) to handle the messages. This can 
be anywhere on your network, but for the purposes 
of the tutorial we’ll install it on the same ‘busybot’ 
Raspberry Pi driving the display. MQTT software 
tends to be very ‘lightweight’, so a Raspberry Pi 
Zero W can easily handle being the server as well as 
a publisher. Mosquitto is probably the most popular 
set of MOTT tools. Installation is straightforward, 
too. Enter this at the command line: 


sudo apt install mosquitto mosquitto-clients 
sudo pip3 install paho-mqtt 


The broker will be automatically installed as a service 
and always be running in the background. We’ve 
also installed Paho, a popular Python library for 
implementing MQTT. 


Clicky goodness with the 
tactile Keybow to send 


messages to the display 
| 


Connectors 


The code for this project does two main jobs: 


listens to the MQTT server for new messages, and 
then takes those messages and scrolls them on the 
display. You can enter the code shown here or get 
the files from magpi.cc/busybotgit. We need the 
code to be running all the time. To do this, create a 
new file from the command line: 


sudo nano /usr/lib/systemd/busybot.service 


Publisher 


— 


MQTT Broker 


{\ 


"I'm on Zoom" 


“I'm on Zoom" 


Subscriber to 
‘pusybot' topic 


Subscriber to 


‘pusybot' topic 


The MQTT protocol is 
perfect for Internet of 
Things projects 


"I'm on Zoom" to 
‘busybot' topic 


Subscriber to 
‘pusybot' topic 
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A The Scroll pHAT HD 


without its diffuser. 
119 very bright LEDs 


TopTip è 


In the upside- 
down? 


If your display is 
looking a little 
topsy-turvy, 

you can flip 
the display by 
uncommenting 
the line 
containing 
scrollphathd. 
flip(1, 1) in 
busybot_ 
magpi.py. 


Enter the code from busybot.service. (Change 
the paths if you’ve created the code elsewhere.) 
Save the file (CTRL+X and then Y), then enter 
these commands: 


sudo systemctl enable /usr/lib/systemd/ 
busybot.service 
sudo systemctl start busybot 


07 Testing time 

Let’s confirm that the code is working. 
Using the Paho MOTT libraries, the code subscribes 
to the MQTT topic ‘busybot’ on the broker. 
Whenever anything publishes a line of text to that 
topic, busybot will be notified, the text delivered 
and then displayed. We can check everything 
is working using the Mosquitto command line 
publishing tool: 


mosquitto_pub -h localhost -t busybot -m 
"Hello from MagPi" 


busybot.service 


> Language: Bash 


01. [Unit] 


002. Description=busybot 


004. [Service] 


005. ExecStart=/usr/bin/python3 /home/pi/busybot/busybot_magpi.py 
006. Restart=on-failure 


007. User=pi 


008. Group=pi 


010. [Install] 


011. WantedBy=multi-user.target 
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A Need more buttons? Try 
the nine-key Keybow 


If you see the messages scrolling across, then 
everything is working. Send any message you wish, 
or a blank space to clear the display. 


Assemble the Keybow 

Now we have our display working, it’s time 
to turn our attention to sending the messages. 
MOTT is widely supported and you can get clients 
for almost every platform and programming 
language in common use. That means we can send 
messages to the display from pretty much anywhere. 
In this tutorial, we’re going to use Pimoroni’s 
Keybow interface to provide a quick way of setting 
messages. On the second ‘buttonbot’ Raspberry 
Pi WH, assemble the Keybow as instructed at 
magpi.cc/assemblekeybowmini, but don’t install 
Keybow OS - we’ll stick with Raspberry Pi OS Lite. 


m Whenever anything publishes 
a line of text to that topic, 
busybot will be notified Ø 


Keybow setup 

We’ll now add some code to send messages 
to the MQTT broker when buttons are pressed. 
First, from the command line, we need to install 
some dependencies on buttonbot: 


sudo apt install python3-pip git 
sudo pip3 install keybow paho-mqtt 


Now get the code from GitHub: 
cd 
git clone https://github.com/mrpjevans/ 


busybot.git 


We can now test the Keybow with a simple example: 


cd ~/busybot 
python3 test_keybow. py 


Press the keys. Do they all light up? Then all is well. 


busybot_magpi.py 
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DOWNLOAD 
THE FULL CODE: 


Keybow code 

In the busybot directory, have a look at 
buttonbot.py. You’!] also need to change the name 
of the MQTT broker and/or topic if you’ve used 
something different. 

We need to make sure the code is always 
running, just like busybot. Again, we’ll create a 
service to do this. From buttonbot’s command line, 
go through the process in Step 6 to create a service 
file and enable it. Just make sure you change the 
ExecStart line to: 


ExecStart=/usr/bin/python3 /home/pi/busybot/ 
buttonbot.py 


Save the file and enable it as before. 


Testing and tinkering 

Everything should now be ready. With both 
Raspberry Pi Zero computers running, try pressing 
a key on the Keybow. A message will now scroll 
across the display on the other Raspberry Pi Zero. 
Make sure all three keys work. You’re now ready to 
start customising the system to your own needs. If 
you edit buttonbot.py, you'll see some documented 
options for changing the messages and the colours 
of the keys. Free free to experiment, make changes, 
and make this code your own. If you need more 
than three messages, see if you can alter the code to 
support key press combinations, which would give 
you up to seven options. 


Python vs C++ 

As the display doesn’t ‘know’ about 
buttonbot’s existence, it means that anything 
capable of speaking MQTT can send messages to 
busybot to set the scrolling text. It could be done 
from the command line or when a certain event 
happens. If you’ve been following the Home 
Assistant (HA) series in The MagPi, then you may 
be interested to know that HA speaks MQTT, so 
the display could be tied to a temperature/motion 
sensor. Have fun dreaming up new ideas. M 


> Language: Python 3 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 
020. 
021. 
022. 
023. 
024. 
025. 
026. 
027. 
028. 
029. 
030. 
031. 
032. 
033. 
034. 
035. 
036. 
037. 
038. 
039. 
040. 
041. 
042. 
043. 
044. 
045. 
046. 
047. 
048. 
049. 
050. 
051. 
052. 
053. 
054. 
055. 
056. 
057. 
058. 
059. 
060. 
061. 
062. 
063. 
064. 


© magpi.cc/busybotgit 


import time 
import scrollphathd 
import paho.mqtt.client as mqtt 


# Change these to suit your needs 
broker = '192.168.0.100' 
client_name = 'busybot' 

topic = 'study/busybot' 
brightness = 0.1 


current_message = 


def scroll_message(): 
# Original function by Pimoroni x 
global current_message 
while True: 


# No message? Don't do anything. 
if len(current_message) is ð: 
scrollphathd.clear() 
time.sleep(1) 
continue 


# Clear the display and reset scrolling to (0, 9) 
scrollphathd.clear() 

length = scrollphathd.write_string(current_message) 
scrollphathd. show() 

time.sleep(@.5) 


length -= scrollphathd.width 


# Now for the scrolling loop... 
while length > @: 
# Scroll the buffer one place to the left 
scrollphathd.scrol1(1) 
scrollphathd. show() 
length -= 1 
time.sleep(@.2@2) 


time.sleep(@.5) 


def on_message(client, userdata, message): 

global current_message 

print('MQTT Message received’) 

current_message = message.payload.decode(“utf-8") 

if len(current_message) == @: 
print('Clearing message’ ) 

else: 
print('Scrolling 


+ current_message) 


print('Starting') 

client = mqtt.Client(client_name) 
client. connect (broker) 
client.subscribe(topic) 
client.on_message = on_message 
print('Listening to ' 
client.loop_start() 


+ topic) 


scrollphathd.set_brightness(brightness) 
scroll_message() 
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MégPi 


GAME OVER. Points: 446 


Wireframes i 


Ea 


Wire 


ABS 


> 


ARAGAMI 


Wireframe 


This tutorial first appeared 
in Wireframe, our sister 
magazine that lifts the 

lid on the world of video 
games. Every issue 
includes tutorials and 
in-depth interviews, along 
with news and reviews 

of the latest indie and 
triple-A games. 

To find out more, visit their 
website at wfmag.cc. 
Check out their 


subscription offers at 
wfmag.cc/subscribe. 


Code your own 


AUTHOR 
JORDI SANTONJA 


E 
r 


ipe Mania, also called Pipe 
Dream in the US, is a puzzle 
game developed by The 
Assembly Line in 1989 for 
Amiga, Atari ST, and PC, 

and later ported to other platforms, 
including arcades. The player must place 
randomly generated sections of pipe onto 
a grid. When a counter reaches zero, 
water starts to flow and must reach the 
longest possible distance through the 
connected pipes. 

Let's look at how to recreate Pipe Dream 
in Python and Pygame Zero. The variable 
start is decremented at each frame. It 
begins with a value of 68*3@, so it reaches 
zero after 30 seconds if our monitor runs 
at 60 frames per second. In that time, the 
player can place tiles on the grid to build a 
path. Every time the user clicks on the grid, 
the last tile from nextTiles is placed on the 
play area and a new random tile appears 
at the top of the next tiles. randint(2,8) 


computes a random value between 2 and 8. 
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Pipe Mania puzzler 


Create a network of pipes before the water starts 


grid and nextTiles are lists of tile values, 
from 0 to 8, and are copied to the screen 
in the draw function with the screen.blit 
operation. grid is a two-dimensional list, with 
sizes gridWidth=10 and gridHeight=7. Every 
pipe piece is placed in grid with a mouse 
click. This is managed with the Pygame 
functions on_mouse_move and on_mouse_down, 
where the variable pos contains the mouse 
position in the window. panelPosition 
defines the position of the top-left corner 
of the grid in the window. To get the grid 
cell, panelPosition is subtracted from pos, 
and the result is divided by tileSize with 
the integer division //. tileMouse stores the 
resulting cell element, but it is set to (-1,-1) 
when the mouse lies outside the grid. 

The images folder contains the PNGs 
with the tile images, two for every tile: the 
graphical image and the path image. The 
tiles list contains the name of every tile, and 
adding to it _block or _path obtains the name 
of the file. The values stored in nextTiles and 
grid are the indexes of the elements in tiles. 


Code your own Pipe Mania puzzler 


to flow in our re-creation of a classic puzzler 


The image waterPath isn't shown to the 
user, but it stores the paths that the water 
is going to follow. The first point of the 
water path is located in the starting tile, 
and it's stored in currentPoint. update calls 
he function CheckNextPointDeleteCurrent, 
when the water starts flowing. That 
function finds the next point in the water 
path, erases it, and adds a new point to 
he waterFlow list. waterFlow is shown to the 
user in the draw function. 

pointsToCheck contains a list of relative 
positions, offsets, that define a step of two 
pixels from currentPoint in every direction 
o find the next point. Why two pixels? To be 
able to define the ‘cross tile, where two lines 
cross each other. In a ‘cross’ tile the water 
flow must follow a straight line, and this 
is how the only points found are the next 
points in the same direction. When no next 
point is found, the game ends and the score 
is shown: the number of points in the water 
path, playState is set to @, and no more 
updates are done. ® 


Pipe-wrangling in Python 


Here's Jordi’s code for a Pipe Mania-style puzzler. To get it working on your system, 
you'll need to install Pygame Zero — full instructions are available at wfmag.cc/pgzero. 


# Pipe Mania 
from pygame import image, Color, Surface 
from random import randint 


gridWidth, gridHeight = 10, 7 

grid = [[9 for x in range(gridWidth)] for y in range(gridHeight)] 
tileSize = 68 

panelPosition = (96, 96) 

numberNextTiles = 5 

nextTiles = [randint(2, 8) for y in range(numberNextTiles)] 
nextTilesPosition = (16, 28) 

tileMouse = (-1, -1) 


tiles = ['empty', 'start', 
‘hori', 'vert', ‘cross', 
"bottomleft', 'bottomright', 
'topleft', ‘topright'] 


pathTiles = [image.load('images/'+tiles[i]+'_path.png') for i in 
range(1,9)] 


waterPath = Surface((gridWidth*tileSize, gridHeight*tileSize)) 
waterPath. fill(Color('black')) 

grid[3][2] = 1 # start tile 

waterPath.blit(pathTiles[0], (2 * tileSize, 3 * tileSize)) 
currentPoint = (2 * tileSize + 43, 3 * tileSize + 34) 
waterFlow = [] 

start = 60*30 # 30 seconds 


playState = 1 


pointsToCheck = [(2, 2),( 2,2),(-2, ®),( 0,-2), 
(2, 1),€ 1,2),€-2, 1),€ 1,-2), 
(2,-1),€1,2),€-2,-1),¢-1,-2), 
(2,-2),€ 2,2),€-2, 2),(-2,-2)] 


def draw(): 
screen.blit('background', (0,2)) 
for x in range(gridWidth): 
for y in range(gridHeight): 
screen. blit(tiles[gridLy][x]]+'_block', ( 
panelPosition[0] + x * tileSize, 
panelPosition[1] + y * tileSize)) 
for y in range(numberNextTiles): 
screen.blit(tiles[nextTiles[y]]+'_block', ( 
nextTilesPosition[2@], 
nextTilesPosition[i] + y * tileSize)) 
for point in waterFlow: 
screen.blit('water', point) 
if playState == 1: 
if tileMouse[0] >= ðO and tileMouse[1] >= 0: 
screen.blit(tiles[nextTiles[-1]]+'_block', ( 
panelPosition[0] + tileMouse[0] * tileSize, 
panelPosition[1] + tileMouse[1] * tileSize)) 
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) 


Download 


the code 
from GitHub 
wfmag.cc/ 
wfmag46 


if start > 0: 
screen.draw.text("Start in " 
+ str(start // 60), center=(400, 50), fontsize=35) 
else: 
screen.draw.text("GAME OVER. Points: 
"+str(len(waterFlow)), center=(400, 50), fontsize=35) 


def update(): 
global start, playState 
if start > 0: 
start -= 1 
elif playState == 1: 
if not CheckNextPointDeleteCurrent(): 
playState = 0 


def CheckNextPointDeleteCurrent(): 
global currentPoint 
for point in pointsToCheck: 
newPoint = (currentPoint[0] + point[0], currentPoint[1] 
+ point[1]) 
if newPoint[0] < O or newPoint[1] < O or newPoint[0] >= 
gridWidth*tileSize or newPoint[1] >= gridHeight*tileSize: 
return False # goes outside the screen 
if waterPath.get_at(newPoint) != Color('black'): 
waterPath. set_at(newPoint, Color('black')) 
waterFlow.append((newPoint[0] + panelPosition[@] - 4, 
newPoint[1] + panelPosition[1] - 4)) 
currentPoint = newPoint 
return True 
return False # no next point found 


def on_mouse_down(pos): 
if playState == 1 and tileMouse[0] >= O and tileMouse[1] >= 


if grid[tileMouse[1]][tileMouse[0]] != 1: # not start 

tile 

grid[tileMouse[1]][tileMouse[9]] = nextTiles[-1] 

waterPath.fill(Color('black'), (tileMouse[0] * 
tileSize, tileMouse[1] * tileSize, tileSize, tileSize)) 

waterPath.blit(pathTiles[nextTiles[-1] - 1], 
(tileMouse[0] * tileSize, tileMouse[1] * tileSize)) 

for i in reversed(range(numberNextTiles - 1)): 

nextTiles[i + 1] = nextTiles[i] 
nextTiles[0] = randint(2, 8) 


def on_mouse_move(pos): 
global tileMouse 
if playState == 1: 
tileMouse = ((pos[9] - panelPosition[0])//tileSize, 
(pos[1] - panelPosition[1])//tileSize) 
if pos[0] < panelPosition[0] or pos[1] < panelPosition[1] 
or tileMouse[0] >= gridWidth or tileMouse[1] >= gridHeight: 
tileMouse = (-1, -1) # mouse outside panel 
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Turbocharge Raspberry 
Pi 400 with an M. 
SATA SSD drive 


Boost your storage speeds with a super-fast M.2 SSD and 


learn how to adjust boot order in Raspberry Pi OS 


Lucy 
Hattersley 


Lucy is editor of The 
MagPi and loves her 
Raspberry Pi 400 

as well as her 8GB 
Raspberry Pi 4. 
Sometimes it's hard 
to pick a favourite. 


magpi.cc 


| You'll Need 


> M.2 SSD 
magpi.cc/430s 


> M2 SATA to USB 3.1 
SSD Enclosure Kit 
(TSCM42S) 
magpi.cc/tsem42 


» Raspberry Pi 400 
magpi.cc/ 
raspberrypi400 


Argon (magpi.cc/argononem2) which 
transformed our Raspberry Pi 4 by 
upgrading the boot drive to an M.2 SSD. 

The result was a tenfold increase in storage speed, 
making for faster performance across the board. 
Apps load more quickly, and browsing the internet 
is vastly improved. M.2 SATA is also great for 
working with large, demanding files such as video, 
large photo images, and big data files. 

The latest offering from Raspberry Pi and our 
favourite all-in-one computer is Raspberry Pi 400. 


R ecently we looked at a superb case from 
a4 


Here, the microSD card is ejected from 
Raspberry Pi 400 so it doesn't override the 
boot from the USB 3.0 drive. Adjusting the 
default boot order enables you to boot from 
the M.2 drive with the microSD card inserted 
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So we set about sourcing a compatible solution for 
Raspberry Pi 400. Thanks to the USB 3.0 ports on 
the rear of Raspberry Pi 400, and recent default 
support for USB boot, it turns out to be easy to 
upgrade a Raspberry Pi 400 in the same manner. 

All you need to do is source a compatible M.2 
SATA drive and M.2 SATA to USB 3.0 enclosure. Put 
the two together and hook the unit up to Raspberry 
Pi 400, then copy across the operating system and 
you’re good to boot. 

We used a Transcend M.2 SSD 430S 
(magpi.cc/430s) and Transcend TSCM42S USB 


The M.2 drive sits inside this 


housing and is connected 
directly to the blue USB 3.0 
port on Raspberry Pi 400 


512GB Transc 
TS512GM D end 


TOAG 


1 2020 


Made in Taiwan DC e3 avere t SA aR 


FE @ ome ZS K 


A ATranscend M.2 SSD drive with a SATA III connection 
(on the Left) 


enclosure (magpi.cc/tscm42). The Transcend 430S 
was 512GB, a mighty upgrade from the 16GB card 
included with Raspberry Pi 400. However, you don’t 
need to purchase such a huge drive and the 128GB 
model will be more than enough for most use cases. 


Assemble the drive 

We start by assembling the M.2 drive 
enclosure. Our M.2 SATA to USB 3.1 SSD Enclosure 
Kit (TSCM42S) contains a SATA III to USB board 
that the M.2 SSD is mounted on. Place the SATA III 
interface into the socket and gently push the M.2 
SSD. Then, a single screw is used to hold the M.2 
SSD in place. Once the M.2 SSD drive is affixed to 
the board, we use the enclosure to contain it. The 
assembly process will vary depending on which M.2 
drive and enclosure you use, but most will follow a 
similar pattern. 


Set up the drive 

If you want to install a fresh installation 
of Raspberry Pi OS to the M.2 SSD drive, then use 
Raspberry Pi Imager (magpi.cc/imager) to install 
the OS directly to the drive. You can do this on any 


pn sit Hh fi Wit anaj C € 


a 


Made in Taiwan OC +3.3V === 15A ek 


ZSE 


computer, including your Raspberry Pi running 
from a microSD card. See the ‘Using Imager’ box 
(overleaf) and head to Step 4 after installing your 
fresh installation. 

Another option is to boot your Raspberry Pi from 
the microSD card and clone the current operating 
system to the M.2 SSD drive. Boot Raspberry Pi 400 
from the microSD card and - once Raspberry Pi 
OS is running - make sure your microSD card is 
running the latest version of Raspberry Pi OS: 


sudo apt update 
sudo apt full-upgrade 
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Copy the drive 

Connect the M.2 drive to one of the two blue 
USB 3.0 connections. Open the Raspberry Pi menu 
and choose Accessories and SD Card Copier. 

Choose the microSD card in Copy From Device; 

ours is marked ‘SC16G (/dev/mmceblko)’. In Copy To 
Device, select the M.2 drive. It should be mounted 
on /dev/sda and the only other option available. 


& Transcend 


TopTip è 


Bootloader 
configuration 


If you intend 

to alter the 
bootloader 
configuration 
file, take a look 
at the Raspberry 
Pi 4 bootloader 
configuration 
documentation. 
magpi.cc/ 
bootloader 


SD Card Copier is 
used to duplicate the 
boot image on your 
microSD card to the 
M.2 SSD drive 


4 The M2 SSD adapter 


translates the SATA III 
interface on the M.2 
SSD drive into a 
USB-C connection 
This is used with a 
USB-C to USB-A 
cable to connect 

the drive to the blue 
USB 3.0 connection 
on Raspberry Pi 400 
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A GNOME Disks running 
a benchmark test that 
shows the M.2 SSD 
drive running vastly 
faster than the 
microSD card 


TopTip è 


Back up to 
microSD card 


When booting 
into your M.2 
drive, the microSD 
card can be used 
as a backup (as 
long as your M.2 
drive isn't using 

a larger amount 
of storage than 
the microSD). Use 
SD Card Copier in 
reverse, with the 
M.2 drive as the 
‘Copy from’ source 
and the microSD 
card as the ‘Copy 
to’ target. 


Using Imager 


If you'd prefer to start with a fresh installation of 
Raspberry Pi OS, it is possible to use Raspberry 
Pi Imager instead of SD Card Copier. This app will 
download the latest version of Raspberry Pi OS, 
format your hard drive, and install the OS (all at the 
click of a button). 

Boot up Raspberry Pi OS using the microSD card 
and install Raspberry Pi Imager with Terminal: 


sudo apt update 
sudo apt install rpi-imager 


Choose Raspberry Pi applications menu > 
Accessories > Imager to open the program. Click 

on ‘Choose OS' and select ‘Raspberry Pi OS (32-bit). 
Next, click on ‘Choose SD Card’ and select your 
external M.2 drive from the SD Card menu. Click on 
‘Write’ to download the operating system and write a 
fresh installation to the M.2 drive. 


Raaptesny Pi iraga VIS 
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Make sure to tick New Partition UUIDs (this 
will enable you to mount and access both devices 
at the same time). Click Start and Yes at the 
‘erase all content’ warning menu to begin the 
copying process. 


Boot into M.2 

When SD Card Copier has finished 
duplicating the contents of the microSD card to the 
M.2 drive, you will be able to use the latter to boot 
and run your Raspberry Pi 400. 

Power off your Raspberry Pi (choose Shutdown 

> Shutdown from the Raspberry Pi applications 
menu). Now remove the microSD card from 
Raspberry Pias it has boot priority over the external 
M.2 drive. Press the FN and Power (F10) keys to 
power Raspberry Pi 400 back up. It will boot and run 
from the M.2 drive. 


m You should notice a speed 
improvement when using 
the M.2 drive over the 
microSD card Ø 


Install GNOME Disks 

You should notice a speed improvement 
when using the M.2 drive over the microSD card. 
Opening programs and browsing the web will be 
much faster. To get detailed information about the 
speed of M.2, you can benchmark the drive with 
GNOME Disks. Open a Terminal window and install 
it with: 


sudo apt update 
sudo apt install gnome-disk-utility 


Open the Raspberry Pi applications menu and 
choose Accessories > Disks to open GNOME Disks. 


Speed-test drive 

Select the rootfs partition and click the 
‘Additional partition options’ icon (shaped as two 
cogs); choose Benchmark Partition. Click Start 
Benchmark and Start Benchmarking to test the 


drive. We get an average read rate of 382.4MB/s 
(much faster than our microSD card). 

Insert the microSD card and select it in GNOME 
Disks to perform a comparative test. We get just 
44.9MB/s in comparison. 
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EEPROM and boot order 


07 Swap boot order 

You can now use Raspberry Pi 400 with the 
M.2 drive attached and the microSD card ejected 
(as it will boot from the M.2 drive). If you insert the 
microSD card, the EEPROM (electrically erasable 
programmable read-only memory) in Raspberry 
Pi 400 will prioritise the microSD card over USB. 
Following a recent update to raspi-config, the 
option to prioritise USB boot over microSD is just a 
few clicks away. Open Terminal and enter: 


sudo raspi-config 


Use the arrow keys to choose Advanced Options and 
Boot Order, then pick ‘B2 USB Boot’. The screen will 
say ‘USB is default boot device’. Press ENTER and 
choose Finish and then Yes to ‘Would you like to 
reboot now?’ 

When Raspberry Pi reboots, it will start up from 
the M.2 SDD connected to USB (even if the microSD 
card is inserted). You can now use your Raspberry 
Pi 400 with the M.2 SSD drive as the default. I 


B1 50 Card Boot Boot from SD Card if available. otherwise boot from USB 


B3 Network Boot Boot from networ! SO car 


A Use raspi-config to set USB as the default boot option 


The option to prioritise USB over microSD can now be found in raspi-config. If you 
want to see what is happening under the hood (or customise your own boot mode) 
you'll want to edit the EEPROM configuration. 

View the current EEPROM configuration: 


rpi-eeprom-config 
This is similar to the config.txt file. The last option will be: 


BOOT_ORDER=0x#41 


The configuration ‘oxf41’ means try the SD card followed by USB mass storage, 
then restart. The values after ‘ox’ are read from right to left. 


Anew boot order 

We are looking to change the BOOT_ORDER field to ‘oxf14' This will boot from the 

USB device ‘4’, then the microSD card ‘1’, followed by a restart 'f if neither is detected. 
To edit it and apply the updates to the latest EEPROM release, enter the 

following in Terminal to open the boot.conf file in your text editor (the default is 

Nano, which we're using here): 


sudo -E rpi-eeprom-config --edit 
Change ‘BOOT_ORDER-=oxf41' to: 


BOOT_ORDER=0x#14 


Press CTRL+O and then CTRL+X to write the file and quit Nano (or save and quit in 
your preferred text editor). Terminal will report ‘EEPROM update pending. Please 
reboot to apply the update’ Restart your Raspberry Pi to apply the update. 


sudo reboot 


BOOT_ORDER fields 
The BOOT_ORDER property defines the sequence for the different boot modes. It 
is read right to left and up to eight digits may be defined. 

The default setting is ‘oxf41. Read from right to left, this setting is SD CARD, 
USB-MSD, then RESTART. 


i 


0X1 SD CARD SD card (or eMMC on Compute Module 4) 
0X2 NETWORK Network boot 
0x3 RPIBOOT RPIBOOT - see magpi.cc/usbboot (since 
2020-09-03) 
0x4 USB-MSD USB mass storage boot (since 2020- 
09-03) 
USB 2.0 boot from USB Type-C socket 
0x5 BCM-USB-MSD or USB Type-A socket on CM4 IO board 
(since 2020-12-14) 
Stop and display error pattern (since 
oxe STOP 2020-09-03). A power cycle is required 
to exit this state 
exe RESTART Start again with the first boot order 


field (since 2020-09-03) 
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Mike Cook 


Veteran magazine 
author from the old 
days, writer of the 
Body Build series, 
plus co-author of 
Raspberry Pi for 
Dummies, Raspberry 
Pi Projects, and 
Raspberry Pi Projects 
for Dummies. 


magpi.cc/mikecook 


Action 

Left-click 

Shift+left-click 
Ctri+left-click (edit mode) 
Left-click+drag 
Alt+tleft-click (edit mode) 
Middle-click+drag 
Shift+middle-click+drag 
Ctrl+middle-click+drag 


Right-click 


Cheap Trills for all 


Using the ring Trill Sensor, see how you can make a 
wind-up music box with replaceable music cylinders 


the Trill sensors using Python. Now we’ll 

show you how to use these sensors in three 
different projects: specialised mouse control, a 
jukebox player, and your very own virtual wind-up 
music box. 


| ast month we looked at how to interact with 


Smart mouse control 

One of the most useful things you could 
add to a piece of established software is smart 
mouse control. For example, take an application 
like the 3D modelling application Blender. It is 
quite a dense interface requiring you to remember 
multiple key combinations to get into different 
modes. In our opinion, one of the most confusing 
is the number of different types of dragging you 
can do (see Figure 1). How about if we had some 
touch sensors, so that each touch sensor controlled 


one type of drag or zoom? 


Result 

Select 

Add to selection 
Remove from selection 
Box selection 
Edge/Face loop select 
Rotate view 

Pan view 

Zoom view 

Context menu 


A Figure 1 Actions in Blender 
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PyAutoGUI 
The difficulty is how do we get a Python 
program to control the mouse? Enter PyAutoGUI, 
an extension that automates graphical user 
interface control. You can obtain it easily by going 
to Add/Remove Software in Raspberry Pi OS’s 
Preferences menu and searching for it. Scroll down 
to the name, tick the box next to the name, and 
click on the Apply button; after a short time, you’ 
have it. No need to even reboot your machine. 


Direct mapping 

The simplest way of using a Trill sensor is 
by mapping the output of one directly to what you 
want to control. The positional output for a sensor 
is a floating point number that goes from 0 to 1.0, 
so mapping is simple. For mouse movements this 
means multiplying the sensor’s X and Y outputs 
by the screen width and height, to get the mouse 
position to move to, plus detecting a second touch 
on the sensor to trigger a click. We show you how 
in the trill_simple_mouse.py program (download 
all the code from magpi.cc/pibakery). 


Incremental mapping 

You can get a remarkable degree of control 
by rolling your finger rather than dragging it, but 
using the direct mapping can be a bit coarse for 
large screens. On laptops, the touchpad control 
often covers only part of the screen. To do this, a 
program has to add any new movement from the 
Trill sensor to the current mouse position. We show 
you how to do this in the trill_mouse.py code. 


"i 


The Trill ring sensor is 
hooked up to Raspberry Pi 


Finally, by adding a ring sensor to the square sensor, 
you can emulate a scrolling centre button mouse 

- see the code trill_simple_mouse_scroll.py for 
how to do this. 


Simple jukebox 

We can use the ring sensor alone, to control 
the playing of music files, stored in the top-level 
Music directory with the simple_jukbox.py code. 
Here, the Music directory is scanned to compile 
a list of all files it contains. Then, by using the 
Trill ring sensor, you can show them one at a 
time in the console. Adding a second touch to the 
sensor will then play that track using the built-in 
OMXPlayer. The track will then be played to the 
end. Stopping a track isn’t quite so simple. 


More control 

In order to have more control over 
OMxXPlayer, you have to use omxplayer-wrapper — 
installed with this Terminal command: 


pip3 install omxplayer-wrapper 


Trill Ring Jukebox 

Pross Ctrl-C to stop 

9 files found 

01 When You Finish Me.wav 
@2 Wasteland.wav 

3 Witching Stone.wav 

@4 Rats.wav 

@5 Heaven And Hell.wav 


Virtual music box playing 


Trill Ring Juk 

Press Ctrl-C tos 

9 fites found 

61 When You Finish Me. wav 

02 Wasteland. wav 

@3 Witching Stone. wav 

@4 Rats. wav 

PS Heaven And Hell.wav 

playing 05 Heaven And Hell .wav 


sseemessssssss=== RESTART: /home/pi/MagPi/Tritl 


Tritt Ring Jukebox 

Press Ctri-C to stop. 

9 files found 

@1 When You Finish Me.wav 

02 Wasteland.wav 

83 Witching Stone.wav 

Q4 Rats. wav 

05 Heaven And Hell.wav 

Playing 05 Heaven And HOll.wav 
3 ring sensor touches - stopping 
Finished playing 


This allows you to send control messages to the 
player while it is playing a track. So we used that 
feature to stop a track while one was playing, by 
giving three touches on the ring. This turned out 
to be quite tricky because once a track has stopped, 
calls to read the status of the track crash the code. 
The code jukebox.py shows how we did this, and 
Figure 2 shows how it looked. 


m Run your finger round the 
ring to emulate winding up 
the music box Ø 


07 A music box 
All the other projects here do not use a 

graphical user interface, but our final one does. The 
code is called graphic_music_box.py. The screen 
shows a Trill ring sensor surrounded by a halo of 
24 coloured circles representing LEDs (Figure 3). 
Operation is simple: run your finger round the ring 
to emulate winding up the music box. As you wind, 
the colours change for each full turn of the key. 
When the music box starts off, all the virtual LEDs 
are off — i.e. the same colour as the background; 
the first full turn of the key turns them red. 
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A Figure 2 Using the 
touch-wheel jukebox 


| You'll Need 


> Trill ring sensors 
magpi.cc/trillring 


» Trill square sensors 
magpi.cc/trillsquare 
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> Figure 3 The music 
box playing on its last 
turn of wind 


TopTip è 


Making the 
Trill ring box 


The drawings 
for the ring box 
can be found 

on our GitHub 
page, along with 
all software and 
data files. 


Chunk Number 


0&1 


X+1 


Figure 3 Music Box - 


Winding it up 

When all the LEDs are white, the box is fully 
wound at five turns, and no further winding can 
occur. To start playing, simply remove your finger 
from the ring. With less than twelve LEDs’ worth of 
wind left, the tune becomes increasingly slower, and 
then stops. A real music box has the tune encoded 
with a metal cylinder covered in spikes; in the 
higher-end boxes, these cylinders can be changed. 
With our virtual music box, this can be achieved with 
a double touch on the ring. The name of the new tune 
will be displayed as the window name. 


The sounds 

To create the sounds of the music box, 
we recorded notes from a MIDI sound module 
one at a time using Audacity, the free sound 
recorder application. When downloading it with 
the Add/Remove Software tool, make sure to install 
both the application and the data files. Then, we 


Standard MIDI File format 
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saved each note separately as a WAV file, giving it 
the name of the MIDI note number it represents. 
We recorded notes in the range of 35 to 84, or Bin 
octave -3 to C in octave 2. These were placed into a 
folder called music_box_sounds. 


The cylinders 

The cylinders are files stored in the 
surprisingly named folder cylinders, with the 
extension .cyl. In fact, these are files with a simple 
format that you can generate yourself: they consist 
of a text file, with a top line that contains the name 
of the song, a number containing the tempo, and 
the number 1, all separated by commas. The rest 
of the file comprises lines of three numbers, a 
time stamp, a MIDI note number, and a velocity or 
volume. This last number is used to tell if it is a note 
on or off message: zero for off, non-zero to sound. 


Creating your own cylinders 

While we have six sample cylinders on our 
GitHub page, it is fun to create your own. These 
are formed by taking a MIDI file and stripping it 
down to just the information required. To do this, 
we need to use a little application called ‘midicsv’, 
obtainable via Add/Remove Software. It can only be 
used from the Terminal window by navigating to 
the folder where the .mid file is stored and typing: 


midicsv fileName.mid saveName.csv 


Then we can open up the CSV file in a spreadsheet 
application and delete the information 


we don’t need. 


Start track 

Program numbers ( instrument ) 

Control numbers ( volume / effects ) 

Track Title 

Time stamp, MIDI message, note number, velocity 
Repeat the last line .... until 

End of track 


A Figure 4 The structure of a 
MIDI file 


Remove columns 


greenslevees 
(o 0 Header 1 3 256 
1l 0 Start_track 
1 0 Time_signature 1 3 12 8 
1 0 Key_signature 0 "major" 
1 0 Tempo 727271 
1 0 Titlet "Greensleeves" 
1 0 Textt “Traditional” 
1| 12288 Tempo 1333331 
1| 12288 Tempo 727271 
1| 12288 Time_signature 6 3 36 8 
1| 23744 Tempo 888887 
1| 23936 Time_signature 5 3 12 8 
1| 24320 Tempo 2000000 
1| 24321 End _track 
2 0 Start_track 
2 0 Program_c 0 24 
2 0 Control_c 0 121 0 
2 0O Title_t "Guitar" 
2 0 Note_on_c 0 57 66 
2 128 Note_off_c 0 57 0 
2 128 Note_on_c 0 60 78 
2 128 Note_on_c 0 45 66 
2| 384 Note_off_c 0 60 0 
2| 384 Note_on_c 0 62 81 


Hacking a MIDI file 

A MIDI file consists of a header, along with 
separate information for each instrument or track 
- the format is shown in Figure 4. As our music 
box has only one voice, we are looking for MIDI 
files that contain only one track, or most of the 
tune in one track. Figure 5 shows part a MIDI file 
opened up in a spreadsheet application, annotated 
to show you what information to remove. When 
you have removed these bits, save what remains as 
a CSV file. Open this in a text editor, add the first 
line, and save it as a .cyl file. 


Tempo 

Note that when using a two-dimensional 
sensor, like the square and the hex, it should be 
considered as a single touch sensor only. While it 
can detect multiple touches, it does so by working 
out the number of horizontal and vertical touches 
detected; there can be a different number of these, 
and it can’t pair them up. However, more advanced 
tracking algorithms could be devised for things like 
gesture recognition. 
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DOWNLOAD 
THE FULL CODE: 


© magpi.cc/pibakery 


24320 
24320 
24576 
24576 
24577 


Note_on_c 
Note_on_c 
Note_off_c 
Note_off_c 
End_track 

Start_track 
Program_c 


l 
Remove ne 


Control_c 
Rows 


Control_c 
Control_c 
Control_c 


Title_t “Guitar” 


oocoeogeoooroso sd ©& 


Note_on_c 
128 Note_off_c 
128 Note_on_c 
128 Note_on_c 
384 Note_off_c 


© © © © © © © © © © © © 6 ONY DD DD, 


384 Note_on_c 


To end of file 


So, now you have enough information to start 
using the Trill touch sensors. Next month we will 
see how to mount these sensors into a project, and 
look at some of the things you can do with them. 


m We particularly like the 
results when playing The 
Blue Danube Ø 


Finally 

With such a wide range of notes, some of 
the lower notes sound much more clunky than 
others. We particularly like the results when 
playing The Blue Danube: it sounds like it is being 
played by a bag of spanners. A good source of free, 
simple MIDI files, is 8notes.com - we found it 
best to choose arrangements for single monotone 
instruments like wind or brass. 

Using a Trill ring and a 24 LED ring which 

fits nicely round it, along with a battery, 
amplifier, and speaker, you could implement 
this as a standalone project using a Raspberry 
Pi Pico microcontroller. H 


0 
0 
0 
0 


57 76 
45 77 
67| 0 
45 0 
24 
121 0 
64 o0 
91 48 
10 64 
7 100 7 
57 68 
67| 0 
60 79 
45 67 
60 o 
62 75 


A Figure 5 Data 


to remove from 
spreadsheet view of 
MIDI file 


TopTip è 


Cylinder note 
range 


Notes outside the 
range of 35 to 84 
are flagged while 
loading a cylinder 
file. Lower notes 
result in the 
lowest note 
being played, 

but higher notes 
will crash 

the program. 
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EASY 
Raspberry Pi (Pico) 
PROJECTS 


Don't be intimidated by your new Raspberry Pi Pico microcontroller, 
Here are some great projects being built with Pico. By Lucy Hattersley 


aspberry Pi Pico is a brand new microcontroller be used to add screens, lights, buttons, and audio 
R from Raspberry Pi, shaking up the world of to Raspberry Pi Pico. Along with code examples and 


computing. We covered Pico in-depth last issue the excellent documentation, these make Pico burst 

(magpi.cc/102) and we’re as keen as you are to get to with potential. 
grips with Pico and start making stuff. Microcontrollers There are trailblazers leading the way, with projects 
are a new piece of technology for Raspberry Pi and and examples of how to make the most of Pico, with its 
The MagPi magazine, and coding for them is slightly GPIO pins and interesting PIO (Programmable Input/ 
different from a Raspberry Pi running Raspberry Pi OS. Output) technology. 

Fortunately, there are a lot of people out there In this feature, we’re going to look at some of the 
making Pico life a lot easier. A wide range of Pico things people are making with Pico, and some easy 


products and add-ons are being created. These can ideas for projects to build. 


m There are a lot of people out there making Pico life a lot easier Ø 


TIP 


SOLDERED HEADERS ® 
To test out Raspberry Pi Pico 
projects, and use most of the kit 
mentioned in this feature, you'll 
need to solder header pins onto your 
Raspberry Pi Pico. See The MagPi 
#102 (magpi.cc/102) for a soldering 
guide. Alternatively, Pimoroni or 
SB Components both now sell 
Raspberry Pi Pico devices with 
pre-soldered headers. 
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The breadboard is used for quickly adding 
and removing components without 
soldering. Some breadboards are being 
custom-built for using with Raspberry Pi 
Pico. The Pico Breadboard Kit has GPIO 
pins for the soldered Pico along with 
buttons, LED lights, and a buzzer 


OOnN oD 


The functionality of Pico can be 4 HSNO CA 
i ; i N ERAN E 

expanded directly with add-ons _ ie y, wi TE 

such as the Pico Display Pack, EREINA 

which adds a 1.14-inch IPS LCD — 

display and four buttons 


Soldered pins enable you to attach 
Raspberry Pi Pico to a breadboard 
for experimentation, and also 


Electronic components, like the connect new hardware add-ons 
SparkFun SerLCD display and designed for Pico. Pimoroni and 
sensors pictured can be tested SB Components are selling Pico 
out in the breadboard, and then boards with pre-soldered headers 
wired up directly to Pico if you want to skip the process 
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GET VISUAL WITH 
YOUR PROJECTS 


Bring Pico to life with these visual and sound-based projects 


and 3.5mm minijack sockets to hook up 

speakers and headphones. This makes 
it easy to get visual and aural feedback from 
your programs. 

Raspberry Pi Pico is more lightweight. It is 
possible to create a DVI output using PIO on 
Pico, but most newcomers start by blinking 
the on-board LED and send the classic Hello 
World output to a terminal on another computer 
(magpi.cc/hellopico). Beyond that, you’ ll want 
to start adding electronic kit to get the most 
from Pico. 


R aspberry Pi computers have HDMI output 


Pixel strips 
If you want to create a light show, then NeoPixels 
(also known as WS2812B LEDs) are cheap and 
widely available strips (magpi.cc/neopixels). 
Each strip contains an array of red, green, and 
blue LED lights designed to be controlled by a 
microcontroller. As you’d expect, Pico is perfect 
for controlling NeoPixel light displays. 
HackSpace magazine’s Ben Everard has 
written an article for Raspberry Pi on using 
NeoPixels with Pico (magpi.cc/neopixelpico) 
and you can take a look at the code on GitHub 
(magpi.cc/picolightsgit). 


Visual add-ons 
If you want something custom-built for Pico, 
a range of light displays, small screens, and 
sound boards are already on sale. Few folks have 
stepped up to the Pico platform like Pimoroni 
(magpi.cc/pimoronipico). 

Pimoroni has produced two LED add-ons: 
the Unicorn Pack is a 16x7 grid of colour 
LEDs (magpi.cc/picounicorn) and the Scroll 
Pack (magpi.cc/picoscroll) is a 17x7 grid of 
V The Pico Unicorn Pack 


can be used to create 
dazzling projects 
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white LEDs. The Unicorn Pack can be used 

to create a rainbow display for your window 
(magpi.cc/rainbow), as well as simple 
animations. The Scroll Pack can be used to create 
scrolling text messages (hence the name), and 
it’s also great for displaying graph data and for 
creating a status light. 

In this issue we have our first project that 
makes use of a Pimoroni Pico Pack. On page 40, 
learn to use a Unicorn Pack to build a Pomodoro 
Timer (a productivity tool). 

Mood lighting is another great use for LED light 
displays; the white LEDs of the Scroll Pack or 
Unicorn Pack can be used to light up areas around 
the house, or to throw a spot of colour into a 
specific area, like a display case. 

If you want something larger, the 
PicoPythonHub75 project (magpi.cc/picohub75) 
bounces the word ‘Pico’ up and down on a Hub75 
32x32 RGB LED panel. Hub75 panels are an 
affordable way of adding lots of colourful lights 
to a build, and Pico’s PIO output enables super- 
fast animations. 

LED displays turn up in a range of Raspberry 
Pi projects, partly because a small 8x8 RGB 
LED display was included with the Sense HAT 
for Raspberry Pi. The Sense HAT projects page 
(magpi.cc/sensehatprojects) is packed with ideas 
that could easily be adapted to a Unicorn Pack or 
Hub75 LED display. Everything from a countdown 
timer to a magic 8-ball, advent calendar, and 
weather logger could be adapted from Raspberry 
Pi to Raspberry Pi Pico. 


Adding displays 
Pimoroni’s impressive Pico Display Pack 
(magpi.cc/picodisplaypack) adds a small 
1.4-inch IPS LCD display to the board, with 
four buttons and a single RGB LED. This can be 
used to make a small photo display, or short 
animations, and give feedback on data. You can 
create a digital thermometer using Pico’s internal 
temperature sensor (see chapter 8 of the Get 
Started with MicroPython on Raspberry Pi Pico book, 
magpi.cc/picobook). 

Once you’ve got a screen on Pico, you can 
connect sensors and display the output, opening 


Create mood lighting 
controlled by code with 
Raspberry Pi Pico 

and NeoPixels 


up arange of IoT (Internet of Things) and 


to at 


disp 
conn 


nte 
nte 


sma 
elec 


Get S 


household projects. We look at some of these in 
the electronics projects later, but if you’re going 
tach sensors with Raspberry Pi Pico, a screen 
to display feedback is a great add-on. 

Many of the gaming tutorials later in 

this feature make good use of the Pimoroni 
Display Pack. If you’d prefer to wire up a small 


ay directly, then it’s relatively easy to 
ect a SparkFun SerLCD (magpi.cc/serlcd) 


to Raspberry Pi Pico. You can wire it up to the 
r-Integrated Circuit (12C) or Serial Peripheral 
face (SPI) pins on Pico, and there are control 
methods implemented in MicroPython. These 


l] displays can provide feedback from other 


tronic devices. A good starter project is 
to display the temperature of Pico’s built-in 
temperature sensor. Take a look at chapter 10 of 


tarted with MicroPython on Raspberry Pi Pico 


(magpi.cc/picobook). Hi 


A /) ian 


3D-PRINTED CASE FOR RASPBERRY Pl ) 


Adafruit has created a Lego-compatible mount for Raspberry Pi Pico 
that adds studs to our favourite microcontroller board. This mount fits 
standard bricks or base plates, enabling you to affix Pico into a Lego 
project (magpi.cc/picolegocase). 

The mount features built-in standoffs so you can snap fit the 
Raspberry Pi Pico on top. Taking the project further, The Ruiz Bros have 
made a Pico Enclosure with lights, buttons, a slide switch, and a small 
LiPo battery. You can download the STL files and see instructions on 
Adafruit's website (magpi.cc/pico3dprintedcase). 
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Add some sounds to your projects 
hen it comes to audio output, 
Raspberry Pi Pico is silent. There is 


W no built-in speaker or 3.5mm minijack 
socket. All is very much not lost, however. 

Ben Everard, from The MagPi’s sister 
publication, HackSpace magazine, has 
produced an excellent PIO Buzz tutorial 
(magpi.cc/piobuzz) that explains how to 
wire up a speaker or headphones to PIO 
(Programmable Input/Output). Pico’s PIO 
allows developers to define new hardware 
features in software — expanding its capabilities 
beyond any fixed-function device. 

Ben says it’s “a simple PIO program that 
outputs a tone based on a number going into it. 
I’ve not yet done the maths to work out what 
number means what note, but it seems to give 
a nice range over audible tones. A bit buzzy at 
ower frequencies, but sounds nicer higher up.” 

You might not be able to play music tracks 
through it, but PIO Buzz is a good way to add 
audio feedback to your projects. The tones 


can be used to create alerts, notifications, and 
provide user interface feedback in projects. 


If you’re looking for audio file playback, then the 
Pico Audio Pack (magpi.cc/picoaudiopack) will 
be of interest. It adds a PCM5100A DAC (digital- 
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Pico Audio Pack 


to-analogue converter) to output up to 32-bit, 
384kHz stereo audio through a 3.5mm line-out 
connector. It can also pump out amplified stereo 
from a3.5mm headphone jack. 

With the Pico Audio Pack, you can turn 
Raspberry Pi into a lo-fi synthesizer and 
generate interesting noises in code. If you’re 
creating synth projects, you might also 
want to look at the Pico RGB Keypad Base 
(magpi.cc/picorgbkeyboard). This is a 4x4 row 
of illuminated keys that can be used to create 
a USB keyboard device. These are popular 
amongst video streamers and DJs. Use it to 


The Pico RGB 
Keypad can be 1 
combined with the 
Audio Pack to create 
devices that respond 
to finger taps. 
Perfect for DJs and 
video streamers 


M Create a disco dance 
floor with your fingers @ 


“create a disco dance floor with your fingers,” 
says Pimoroni, “or a Simon Says-style game 
with which to taunt your friends.” 

One thing to note with the Pico Audio Pack 
is that it works with Pico’s C/C++ SDK (with 
MicroPython support planned). So right now 
you’ll need to invest some time in the more 
challenging code base. Still, the possibilities 
for creating a Pico-based digital music player, 
Simple Simon game, DJ system, or DAC for your 
home sound system are worth the investment. M 
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THREE EASY PICO 
PROJECTS ON YOUTUBE 


Print 'N Play is a YouTube channel dedicated to 

building and making. This video covers setting 

up Raspberry Pi Pico and moves on to a range 

of easy electronics projects. The code for each 
project is available on GitHub. 


: k A Reading a temperature from Pico 
magpi.cc/3easyprojects 


magpi.cc/readtempgit 


4 Playing music on Pico a Playing and recording Morse code 
magpi.cc/playingmusicgit magpi.cc/morsecodegit 


PIMORONI 
GITHUB 


It's early days for 
aD VREF Pimoroni's Pico 
products, and example 
R] SP28 code for all of them 
=. is being added to 
—Z56P27  Pimorioni’s GitHub 
s page. Bookmark it and 
` Dorz keep an eye out for 
T RUN new projects. 
? ‘oO GPA magpi.cc/pmpicogit 


Sage ND S 


aO GP18 
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es ss ( 


PROJECTS bitshiftere 


Get creative with Raspberry Pi Pico gaming , ELTA 


ideo games are a staple area of interest 

for any new computer. At first glance, 

you might think that Pico doesn’t lend 
itself to games, but you’d be mistaken. 

PIO enables a lot of the heavy lifting for the 
display and input to be taken away from the 
main controller, freeing the dual-core Arm 
Cortex Mo+ processor to handle the game. 

The result is a surprisingly versatile system 


for gaming. 
i emulated on Raspberry 

Graham Sanderson has shown that If you are looking for a more complete games Pi Pico, with PIO handling 
it’s possible to emulate a BBC Micro and system, then Pimoroni’s PicoSystem the display output 
ZX Spectrum using PIO to output the audio and (magpi.cc/picosystem) is under development. 
VGA graphics. There are no instructions just PicoSystem promises to be a tiny all-in-one 
yet, but you can check out the build on YouTube portable games console being built around the 
(magpi.cc/picobbcmicro). RP2040 microcontroller at the heart of Pico. It 

If you’re looking for a build with features a small IPS LCD screen, joypad, buttons, 
ready-to-roll code, then take a look at Tetris and LiPo battery. 
f : il j he Pico Display Pack R b Pi Pico i ; b à h Y PicoSystem is an all- 

or Pico, built using the Pico Display Pac aspberry Pi Pico is proving to be quite the in-one games console 
(magpi.cc/picodisplaypack). It uses the buttons powerhouse for retro gaming, much more so sae ria 
: : ‘ i owerful 4i 

on the latter to rotate and control the pieces, than you’d first imagine. microcontroller atthe 
and the small screen displays the game. The — ee 
code for Pico Tetris can be found on PasteBin giaa 


(magpi.cc/picotetris). 
The small screen of the Pico Display 
Pack or LEDs of the Pico Unicorn Pack lend y 
themselves to Tamagotchi-style games, and 
you can easily create one for Raspberry Pi Pico 
using animations. There is the Pixel Pet code 
for Raspberry Pi Sense HAT on the projects 
page (magpi.cc/pixelpet) that could be easily 
converted to Raspberry Pi Pico and a Pico Display 
Pack or Unicorn Pack. 


m if you're looking for a 
build with ready-to-roll 
code, then take a look at 
Tetris for Pico Ø 


70 | magpi.cc | Easy Raspberry Pi Pico Projects 


EASY ELECTRONICS 


WITH PICO 


Roll your own projects with components and code 


excellent for learning electronics and 

building small circuits that do all manner 
of things. It’s possible to solder wires and 
components directly to GPIO sockets, but adding 
a pin header enables you to slot Pico into the 
sockets of a breadboard (magpi.cc/breadboard) 
and connect and disconnect components 
without having to solder them. 


| ike all Raspberry Pi boards, Pico is 


M You'll never be short of 
projects to try out Ø 


With pins on Pico, you can follow the 
‘Getting started with Raspberry Pi Pico’ guide 
(magpi.cc/gettingstartedpico). And make sure 
you pick up a copy of Get Started with MicroPython 
on Raspberry Pi Pico (magpi.cc/picobook). You’ll 
also find a fantastic tutorial on using Pico with 
LEDs and buttons on the following pages. 


Easy electronics 

Numerous devices have been developed to 

aid electronic testing and development with 
Raspberry Pi Pico. SB Components has produced 
a Pico Breadboard Kit (magpi.cc/picobread) 

that should make prototyping easier. As well 

as a half-size breadboard, it packs a buzzer, 
four LEDs, and four push-buttons. It also has 
dedicated 5V, 3V3, and GND pins. 

Another device aiming to make electronics 
more accessible is the Pico Explorer Base 
(magpi.cc/picoexplorer). This also features a 
mini breadboard, but one-ups other boards with 
a 240x240 IPS LCD screen and four buttons (to 
create interactive menus for your projects). It 
also has two Breakout Garden slots that you can 
use to quickly slot in devices from Pimoroni’s 
breakout range (magpi.cc/pimoronibreakouts). 
These include everything from air quality 
sensors to haptic feedback buttons. 

If you want to avoid a nest of wires and 
experiment with a range of components, check 
out Seeed’s Grove Shield for Raspberry Pi Pico 
(magpi.cc/groveshield). This enables you to 
plug and play with over 300 Grove modules. 


Seeed has provided a walkthrough to using 
the Grove Shield with Raspberry Pi Pico 
(magpi.cc/groveshieldtutorial) that 
demonstrates how to attach a buzzer, rotary 
angle sensor, OLED display, and temperature 
sensor with Raspberry Pi Pico. 


HATs everywhere 
Another device is the Raspberry Pi Pico HAT 
Expansion (magpi.cc/picohatexpansion). This 
is an input/output board that translates the 
Raspberry Pi Pico pins into the 40-pin header 
found on Raspberry Pi computers. This enables 
you to plug any of the myriad of HATs designed 
for Raspberry Pi into Pico (although it’s worth 
noting that software and APIs designed for 
Raspberry Pi may need translation work to 
function in MicroPython or C/C++). If you havea 
project in Raspberry Pi that’s ripe for conversion 
to Pico, this hardware could be just the thing. 

Pimoroni’s Pico Omnibus Dual Expander 
(magpi.cc/picoomnibus) enables you to double 
up on expansion packs, adding two at once. 
Or, you can use the extra GPIO pins to attach 
jumper wires or circuitry alongside a Pico Pack. 
If that’s not enough, the Pico Decker Quad 
Expander (magpi.cc/picodecker) goes to town 
with support for up to four Pico Pack devices. 
On the board is a ‘landing area’ with labelled 
female headers for attaching Pico, and four 
further landing areas with mirrored headers for 
attaching add-ons. 

One thing’s for sure: with Pico you’ ll never be 
short of projects to try out. mM 
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‘aT! 


DETECTING 


PEOPLE 
WITH Al 


Here is one more 
project that might be 
suitable for the more 
advanced makers 

out there. Kyle from 
Arducam has got 
TensorFlow Lite Micro 


up and running on 
Raspberry Pi Pico and 
has created a tutorial 
on using the machine 
learning framework 
for person detection. 
Connect a camera 

to your Raspberry 

Pi Pico and you 

will be able to use 
image recognition to 
detect people. 
magpi.cc/tfpico 


YV The Grove Shield for 
Raspberry Pi Pico 
enables you to plug 
in over 300 modules 
from the Sesed range 
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Physical computing 
with Raspberry P1 Pico 


Start connecting basic electronic components to your Raspberry Pi Pico 
and writing programs to control and sense them 


SELECTIVE 
IMPORTS 
In both MicroPython 
and Python it's 


possible to import 
part of a library, 


rather than the whole 


library. Doing so can 
make your program 
use less memory, 
and allows you 
to mix and match 
functions from 
different libraries. 
The programs in 
this guide import 
the whole library; 
elsewhere you 
may see programs 
which have lines 
like from machine 
import Pin; this 
tells MicroPython 
to import only the 
‘Pin’ function from 
the ‘machine’ library, 
rather than the 


whole library. 


> Figure 1 The on- 
board LED is found 
to the left of the 


micro-USB connector 
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microcontroller, is designed with physical 

computing in mind. Its numerous general- 
purpose input/output (GPIO) pins let it talk toa 
range of components, allowing you to build up 
projects, from lighting LEDs to recording data about 
the world around you. 

Physical computing is no more difficult to learn 
than traditional computing: if you can do a little 
Python coding, you’ ll be able to build your own 
circuits and program them to do your bidding. 


R aspberry Pi Pico, with its RP2040 


Your first physical computing 

program: Hello, LED! 

Just as printing ‘Hello, World’ to the screen is a 
fantastic first step in learning a programming 
language, making an LED light up is the traditional 
introduction to learning physical computing. You 
can get started without any additional components, 
too: your Raspberry Pi Pico has a small LED, known 
as a surface-mount device (SMD) LED, on top. 

Start by finding the LED: it’s the small 
rectangular component to the left of the micro-USB 
port at the top of the board (Figure 1), marked with 
a label reading ‘LED’. This small LED works just like 
any other: when it’s powered on, it will glow; when 
it’s powered off, it remains dark. 


The on-board LED is connected to one of 
RP2040’s general-purpose input/output pins, 
GP25. This is one of the ‘missing’ GPIO pins 
present on RP2040 but not broken out to a physical 
pin on the edge of your Pico. While you can’t 
connect any external hardware to the pin, other 
than the on-board LED, it can be treated just the 
same as any other GPIO pin within your programs 
- and it makes a great way to add an output to your 
programs without needing any extra components. 

Load Thonny and, with Pico connected to your 
Raspberry Pi, click ‘Python’ at the bottom-right, 
then select ‘MicroPython (Raspberry Pi Pico)’ as the 
interpreter. Click into the script area, and start your 
program with the following line: 


import machine 


This short line of code is key to working with 
MicroPython on your Pico: it loads, or imports, a 
collection of MicroPython code known as a library 
- in this case, the ‘machine’ library. The machine 
library contains all the instructions MicroPython 
needs to communicate with the Pico and other 
MicroPython-compatible devices, extending the 
language for physical computing. Without this line, 
you won’t be able to control any of your Pico’s GPIO 
pins — and you won’t be able to make the on-board 
LED light up. 

The machine library exposes what is known 
as an application programming interface (API). The 
name sounds complicated, but describes exactly 
what it does: it provides a way for your program, 
or the application, to communicate with Pico via an 
interface. The next line of your program provides an 
example of the machine library’s API: 


led_onboard = machine.Pin(25, machine.Pin.OUT) 


This line defines an object called led_onboard, 
which offers a friendly name you can use to refer 
to the on-board LED later in your program. It’s 
technically possible to use any name here - like 
susan, gupta, or fish_sandwich — but it’s best to 
stick with names which describe the variable’s 
purpose, to make the program easier to read 

and understand. 

The second part of the line calls the Pin function 
in the machine library. This function, as its name 
suggests, is designed for handling your Pico’s GPIO 
pins. At the moment, none of the GPIO pins - 
including GP25, the pin connected to the on-board 
LED - knows what they’re supposed to be doing. 
The first argument, 25, is the number of the pin 
yow re setting up; the second, machine. Pin.OUT, 
tells Pico the pin should be used as an output rather 
than an input. 

That line alone is enough to set the pin up, but it 
won’t light the LED. To do that, you need to tell Pico 
to actually turn the pin on. Type the following code 
on the next line: 


led_onboard.value(1) 


M The on-board LED is 
connected to one of 
RP2040's GPIO pins Ø 


It might not look it, but this line is also using the 
machine library’s API. Your earlier line created the 
object led_onboard as an output on pin GP25; this 
line takes the object and sets its value to 1 for ‘on’ — 
it could also set the value to o, for ‘off’. 

Click the Run button and save the program on 
your Pico as Blink.py. Yov’ ll see the LED light up. 
Congratulations — you’ve written your first physical 
computing program! 

You’ ll notice, however, the LED stays lit: that’s 
because your program tells Pico to turn it on, but 
never tells it to turn it off. You can add another line 
at the bottom of your program: 


led_onboard.value(@) 


Run the program this time, though, and the LED 
never seems to light up. That’s because Pico works 
very, very quickly — far more quickly than you can 
see with the naked eye. The LED is lighting up, but 


Figure 2 "a 


for such a short time it appears to remain dark. To 
fix that, you need to slow your program down by 
introducing a delay. 

Go back to the top of your program: click at the 
end of the first line and press ENTER to insert a new 
second line. On this line, type: 


import utime 


Like import machine, this line imports a new library 
into MicroPython: the ‘utime’ library. This library 
handles everything to do with time, from measuring 
it to inserting delays into your programs. 

Go to the bottom of your program, and click on 
the end of the line led_onboard.value(1), then 
press ENTER to insert a new line. Type: 


utime.sleep(5) 


This calls the sleep function from the utime 
library, which makes your program pause for 
whatever number of seconds you typed — in this 
case, five seconds. 

Click the Run button again. This time you’ ll see 
the on-board LED on your Pico light up, stay lit for 
five seconds - try counting along - and go out again. 

Finally, it’s time to make the LED blink. To do 
that, you’ll need to create a loop. Rewrite your 
program so it matches the one below: 


import machine 
import utime 


led_onboard = machine.Pin(25, machine.Pin.OUT) 
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All the holes in each 
rail are connected 


A Figure 2 The internal 
connections on 
a breadboard 


PIN NUMBERS 


When talking about 
the GPIO pins on 
your Pico they're 
usually referred 
to using their full 
names: GP25 for 

the pin connected 
to the on-board 

LED, for example. In 

MicroPython, though, 
the letters G and P 
are dropped - so 
make sure you write 
‘25 rather than ‘GP25' 
in your program, or it 
won't work! 


Physical computing with Raspberry Pi Pico | magpi.cc | 73 


WE Magri | TUTORIAL 


oy At anson Beeseeaean encan 


ennou asc.. Seana 
BSeaan Saeaasns Saeaeaea 
+ 
| 
a SBeaeaeaeaa 
a SSESBeBEB ES 
Ce) Saeaseaeaen 
~ Saeaeaeaeana 
z Saeseaeaeaen 
—onneeseeee 
-Jsaueueuuan 
AS eeeeeeeee 
SBESBSBEBEBEEBRBRBBBS | 
SBeeeeee ee eee eeaaeaeaeauas | 
ennon ass.. enuon asnon SBeaseaa I 


A Figure 3 Your 
Pico is designed 
to sit securely 
in a solderless 
breadboard 


UTIME VS TIME 


If you've 
programmed in 
Python before, you'll 
be used to using 
the ‘time’ library. 
The utime library is 
aversion designed 


for microcontrollers 
like the Pico - the ‘u’ 
standing for ‘p’, the 
Greek letter ‘mu’, 
which is used as a 
shorthand for ‘micro’ 
If you forget and use 
import time, don't 
worry: MicroPython 
will automatically 
use the utime 
library instead. 


while True: 
led_onboard.value(1) 
utime.sleep(5) 
led_onboard.value(@) 
utime.sleep(5) 


Remember that the lines inside the loop need to be 
indented by four spaces, so MicroPython knows they 
form the loop. Click the Run icon again and you’ ll 
see the LED switch on for five seconds, switch off 
for five seconds, and switch on again - constantly 
repeating in an infinite loop. The LED will continue 
to flash until you click the Stop icon to cancel your 
program and reset your Pico. 

There’s another way to handle the same job, too: 
using a toggle, rather than setting the LED’s output 
to 0 or 1 explicitly. Delete the last four lines of your 
program and replace them so it looks like this: 


import machine 
import utime 


led_onboard = machine.Pin(25, machine.Pin.OUT) 


while True: 
led_onboard.toggle() 
utime.sleep(5) 


Run your program again. You’ll see the same 
activity as before: the on-board LED will light up for 
five seconds, then go out for five seconds, then light 
up again in an infinite loop. This time, though, your 
program is two lines shorter: you’ve optimised it. 
Available on all digital output pins, toggle() simply 
switches between on and off: if the pin is currently 
on, toggle() switches it off; if it’s off, toggle() 
switches it on. 
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Using a breadboard 
The following projects in this chapter will 
be much easier to complete if you’re using a 
breadboard to hold the components and make the 
electrical connections. 
A breadboard (Figure 2) is covered with holes 
- spaced, to match components, 2.54mm apart. 
Under these holes are metal strips which act like the 
jumper wires you’ve been using until now. These run 
in rows across the board, with most boards having a 
gap down the middle to split them in two halves. 
Many breadboards also have letters across the 
top and numbers down the sides. These allow you to 
find a particular hole: A1 is the top-left corner, B1 
is the hole to the immediate right, while B2 is one 
hole down from there. A1 is connected to B1 by the 
hidden metal strips, but no hole marked with a1 is 
ever connected to any hole marked with a 2 unless 
you add a jumper wire yourself. 


m Adding electronic 
components to a 
breadboard is simple Ø 


Larger breadboards also have strips of holes down 
the sides, typically marked with red and black or 
red and blue stripes. These are the power rails, and 
are designed to make wiring easier: you can connect 
a single wire from one of your Pico’s ground pins 
to one of the power rails - typically marked with a 
blue or black stripe and a minus symbol - to provide 
acommon ground for lots of components on the 
breadboard, and you can do the same if your circuit 
needs 3.3 V or 5 V power. Note: All holes joined by a 
stripe are connected; a gap indicates a break. 

Adding electronic components to a breadboard is 
simple: just line their leads (the sticky-out metal 
parts) up with the holes and gently push until the 
component is in place. For connections you need to 
make beyond those the breadboard makes for you, 
you can use male-to-male (M2M) jumper wires; 
for connections from the breadboard to external 
devices, like your Raspberry Pi Pico, use male-to- 
female (M2F) jumper wires. 

Never try to cram more than one component 
lead or jumper wire into any single hole on the 
breadboard. Remember: holes are connected 
in rows, aside from the split in the middle, soa 
component lead in A1 is electrically connected to 
anything you add to B1, C1, D1, and F1. 


Push your Pico into the breadboard so it straddles 
the middle gap and the micro USB port is at the very 
top of the board (see Figure 3). The top-left pin, Pin 
o, should be in the breadboard row marked with a 
1, if your breadboard is numbered. Before pushing 
your Pico down, make sure the header pins are all 
properly positioned — if you bend a pin, it can be 
difficult to straighten it again without it breaking. 

Gently push the Pico down until the plastic parts 
of the header pins are touching the breadboard. 
This means the metal parts of the header pins are 
fully inserted and making good electrical contact 
with the breadboard. 


Next steps: an external LED 

So far, you’ve been working with your Pico on 

its own - running MicroPython programs on its 
RP2040 microcontroller and toggling the on-board 
LED on and off. Microcontrollers are usually used 
with external components, though - and your Pico is 
no exception. 

For this project, you’ll need a breadboard, male- 
to-male (M2M) jumper wires, an LED, and a 330 Q 
resistor — or as close to 330 Q as you have available. 
If you don’t have a breadboard, you 
can use female-to-female (F2F) jumper wires, but 
the circuit will be fragile and easy to break. 

Hold the LED in your fingers: you’ ll see one of 
its leads is longer than the other. The longer lead 
is known as the anode, and represents the positive 
side of the circuit; the shorter lead is the cathode, 
and represents the negative side. The anode needs 
to be connected to one of your Pico’s GPIO pins via 
the resistor; the cathode needs to be connected to a 
ground pin. 

Start by connecting the resistor: take one end 
(it doesn’t matter which) and insert it into the 
breadboard in the same row as your Pico’s GP15 pin 
at the bottom-left - if you’re using a numbered 
breadboard with your Pico inserted at the very top, 
this should be row 20. Push the other end into 
a free row further down the breadboard - we’re 
using row 24. 

Take the LED, and push the longer leg - the 


anode — into the same row as the end of the resistor. 


Push the shorter leg - the cathode - into the same 
row but across the centre gap in the breadboard, so 
it’s lined up but not electrically connected to the 
longer leg except through the LED itself. Finally, 
insert a male-to-male (M2M) jumper wire into the 
same row as the shorter leg of the LED, then either 
connect it directly to one of your Pico’s ground pins 
(via another hole in its row) or to the negative side 
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RESISTANCE IS VITAL 


The resistor is a vital component in this circuit: it protects both your 
Pico and the LED by limiting the amount of electrical current the LED 
can draw. Without it, the LED can pull too much current and burn 


itself - or your Pico - out. When used like this, the resistor is known 
as a current-limiting resistor. The exact value of resistor you need 
depends on the LED you're using, but 330 Q works for most common 
LEDs. The higher the value, the dimmer the LED; the lower the value, 
the brighter the LED. 


Never connect an LED to your Pico without a current-limiting resistor, 
unless you know the LED has a built-in resistor of appropriate value. 


of your breadboard’s power rail. If you connect it to 
the power rail, finish the circuit by connecting the 
rail to one of your Pico’s ground pins. Your finished 
circuit should look like Figure 4. 

Controlling an external LED in MicroPython is no 
different to controlling your Pico’s internal LED: 
only the pin number changes. If you closed Thonny, 
reopen it and load your Blink.py program from 
earlier in the chapter. Find the line: 


led_onboard = machine.Pin(25, machine.Pin.OUT) 


Edit the pin number, changing it from 25 - the pin 
connected to your Pico’s internal LED - to 15, the 
pin to which you connected the external LED. Also 
edit the name you created: you’re not using the on- 
board LED any more, so have it say led_external 
instead. You’ll also have to change the name 
elsewhere in the program, until it looks like this: 


import machine 
import utime 


led_external = machine.Pin(15, machine.Pin.OUT) 


while True: 
led_external. toggle() Y Figure 4 The finished 
utime.sleep(5) circuit, with an LED 


and a resistor 


sense seeee seees sones nonon onone, 
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NAMING 
CONVENTIONS 


You don't really 
need to change the 
LED object name 
in the program: it 
would run just the 
same if you'd left it at 
led_onboard, as it's 
only the pin number 
which truly matters. 
When you come 
back to the program 
later, though, it 
would be confusing 
to have an object 
named led_onboard 
which lights up an 
external LED - so 
try to get into the 
habit of making sure 
your names match 
their purpose! 


Inputs: reading a button 

Outputs like LEDs are one thing, but the ‘input/ 
output’ part of ‘GPIO’ means you can use pins 

as inputs too. For this project, you’ll need a 
breadboard, male-to-male jumper wires, anda 
push-button switch. If you don’t have a breadboard, 
you can use female-to-female (F2F) jumper wires, 
but the button will be much harder to press without 
accidentally breaking the circuit. 

Remove any other components from your 
breadboard except your Pico, and begin by adding 
the push-button switch. If your push-button has 
only two legs, make sure they’re in different- 
numbered rows on the breadboard somewhere 
below your Pico. If it has four legs, turn it so the 
sides the legs come from are along the breadboard’s 
rows and the flat leg-free sides are at the top and 
bottom before pushing it home so it straddles the 
centre divide of the breadboard. 

Connect the positive power rail of your 
breadboard to your Pico’s 3V3 pin, and from there to 
one of the legs of the switch; then connect the other 
leg to pin GP14 on your Pico — it’s the one just above 
the pin you used for the LED project, and should be 
in row 19 of your breadboard. 


m Pushing the button has completed the 
circuit and changed the value read Ø 


V Figure 5 Wiringa 
four-leg push-button 
switch to GP14 


If you’re using push-button with four legs, your 
circuit will only work if you use the correct pair of 
legs: the legs are connected in pairs, so you need to 
either use the two legs on the same side or (as seen 
in Figure 5) diagonally opposite legs. 

Load Thonny, if you haven’t already, and start a 
new program with the usual line: 


import machine 


Next, you need to use the machine API to set upa 
pin as an input, rather than an output: 


Seee8s onana anans asooo seeee seees apasa anosa coooa osons 
+ 88888 seses osooso eeees seees seess socso osooso sesee seeee | 
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button = machine.Pin(14, machine.Pin.IN, 
machine. Pin.PULL_DOWN) 


This works in the same way as your LED projects: an 
object called ‘button’ is created, which includes the 
pin number - GP14, in this case - and configures 

it as an input with the resistor set to pull-down. 
Creating the object, though, doesn’t mean it will do 
anything by itself - just as creating the LED objects 
earlier didn’t make the LEDs light up. 

To actually read the button, you need to use the 
machine API again - this time using the value 
function to read, rather than set, the value of the 
pin. Type the following line: 


print(button.value()) 


Click on Run and save your program as Button.py — 
remembering to make sure it saves on Raspberry Pi 
Pico. Your program will print out a single number: 
the value of the input on GP14. Because the input 

is using a pull-down resistor, this value will be o - 
letting you know the button isn’t pushed. 

Hold down the button with your finger, and 
press the Run icon again. This time, you’ll see the 
value 1 printed to the Shell: pushing the button 
has completed the circuit and changed the value 
read from the pin. To read the button continuously, 
you'll need to add a loop to your program. Edit the 
program so it reads as below: 


import machine 
import utime 


button = machine.Pin(14, machine.Pin.IN, 
machine.Pin.PULL_DOWN) 


while True: 
if button.value() == 1: 
print("You pressed the button!") 
utime.sleep(2) 


Click the Run button again. This time, nothing will 
happen until you press the button; when you do, 
you’ll see a message printed to the Shell area. The 
delay, meanwhile, is important: remember, your 
Pico runs a lot faster than you can read, and without 
the delay even a brief press of the button can print 
hundreds of messages to the Shell! 

You’ ll see the message print every time you press 
the button. If you hold the button down for longer 
than the two-second delay, it will print the message 
every two seconds until you let go of the button. 


Inputs and outputs: putting it all together 
Most circuits have more than one component, 
which is why your Pico has so many GPIO pins. It’s 
time to put everything you’ve learned together 
to build a more complex circuit: a device which 
switches an LED on and off with a button. 
In effect, this circuit combines both of the 
previous circuits into one. You may remember you 
used pin GP15 to drive the external LED, and pin 
GP14 to read the button; now rebuild your circuit so 
both the LED and the button are on the breadboard 
at the same time, still connected to GP15 and GP14 
(see Figure 6). Don’t forget the current-limiting 
resistor for the LED! 
Start a new program in Thonny, and begin 
importing the two libraries your program will need: 


import machine 
import utime 


Next, set up both the input and output pins: 


led_external = machine.Pin(15, machine.Pin.OUT) 
button = machine.Pin(14, machine.Pin.IN, 
machine.Pin.PULL_DOWN) 


Then create a loop which reads the button: 


while True: 
if button.value() == 1: 


Rather than printing a message to the Shell, 
hough, this time you’re going to toggle the 

utput pin and the LED connected to it based on 
he value of the input pin. Type the following, 
emembering it will need to be indented by eight 
paces - which Thonny should have automatically 
andled when you pressed ENTER at the end of 

he line above: 


SO EY et Ot cet 


ct. 


led_external.value(1) 
utime.sleep(2) 


That’s enough to turn the LED on, but you’ll also 
need to turn it off again when the button isn’t being 
pressed. Add the following new line, using the 
BACKSPACE key to delete four of the eight spaces — 
meaning the line will not be part of the if statement, 
but will form part of the infinite loop: 


led_external.value(@) 


Your finished program should look like this: 


TUTORIAL | MägPi Ci 


RESISTANCE IS HIDDEN 


Unlike an LED, a push-button switch doesn't need a current-limiting 
resistor. It does still need a resistor, though: it needs what is known as 
a pull-up or pull-down resistor, depending on how your circuit works. 
Without a pull-up or pull-down resistor, an input is known as floating 
- which means it has a ‘noisy’ signal which can trigger even when 
you're not pushing the button. 


So where's the resistor in this circuit? Hidden in your Pico. Just like it 
has an on-board LED, your Pico includes an on-board programmable 
resistor connected to each GPIO pin. These can be set in MicroPython 
to pull-down resistors or pull-up resistors as required by your circuit. 


What's the difference? A pull-down resistor connects the pin to 
ground, meaning when the push-button isn't pressed, the input will be 


o. A pull-up resistor connects the pin to 3V3, meaning when the push- 
button isn't pressed, the input will be 1. 


All the circuits in this guide use the programmable resistors in the 
pull-down mode. 


Saeaean Senses Saeanae Ssaeaan enone 
+ "soe sosoo seess ovco seses 


A Figure 6 The finished 
circuit, with both a 
button and an LED 


import machine 
import utime 


led_external = machine.Pin(15, machine.Pin.OUT) 
button = machine.Pin(14, machine.Pin.IN, 
machine. Pin.PULL_DOWN) 


while True: 
if button.value() == 1: 
led_external.value(1) 
utime.sleep(2) 
led_external.value(@) 


Click on Run and save the program as Switch.py on 
your Pico. At first, nothing will happen; push the 
button, though, and you’ll see the LED light up. Let 
go of the button; after two seconds, the LED will go 
out again until you press the button again. 
Congratulations: you’ve built your first circuit 
which controls one pin based on the input from 
another - a building block for bigger things! Ml 
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SmartiPi Touch Pro 


> SmartiCase > magpi.cc/smartipi » £30 / $35 


DIMENSIONS: 
Dependent on 
configuration: 
see the 

CAD files at 
magpi.cc/ 
smartipiprocad 


COMPATIBILITY: 
Any Raspberry 
Pi computer 
that supports 
the official 
touchscreen 


SIZE OPTIONS 
(DEPTH): 


25mm or 45mm 
clearance 


COLOURS: 


Black or white 


MOUNTING: 
Hinged base, 
wall eyelets, 
and VESA 


MATERIALS: 
ABS plastic, 
metal screw 
threads 


The latest addition to the SmartiPi Touch family brings improved design, 
cooling, and a wealth of options. PJ Evans looks into the case 


e’re big fans of the SmartiCase range 
W here at The MagPi magazine. The 

SmartiPi Touch 2 was a big hit in 2020, 
with a solid 8/10 awarded. Now it’s back with a 
third iteration, the SmartiPi Touch Pro. 

All models mount the official 7-inch Raspberry 
Pi touchscreen and a Raspberry Pi of your choice 
into a single case running from one power supply. 
The result is a small, freestanding unit, perfect 
for kiosk-style applications. Add a keyboard 
and monitor for a small, but perfectly formed, 
workstation. 

The Touch Pro is a solid refinement of its 
predecessor. Although similar in appearance, the 
optional camera mount has been moved to the 


base of the screen, which gives it a slimmer profile. 


The internals have been redesigned to create more 
space: in fact, you can fit two HAT form-factor 
devices side by side. Cooling has been improved 
with a small optional fan mounted on rubber 
pillars to reduce vibration. 


Aw 


A Multiple mounting options make this case suitable for both 
home and business applications 
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Construction was simple and completed in 
about 20 minutes, thanks to a well-written online 
guide. It’s even easier than the previous models. 
Everything you need is included, along with 
options for fan covers, a range of port blockers 


w The Touch Pro is a 
solid refinement of 
its predecessor Ø 


for both Raspberry Pi 3 and 4 configurations, 
ribbon cables for the display and camera, and - 
very neatly - a Y-adapter for both USB micro and 
USB C that now mounts inside the case to givea 
smart single connector to run both the device and 


screen. We also received the metal base accessory 
(sold separately) which gives the assembly a solid 
footing; your cat would struggle to topple this. 


Room for everything 
Space is acommon frustration in Raspberry 
Pi cases, and it is addressed head-on with the 
SmartiPi Touch Pro. There is a choice of two rear 
covers, one with 25mm clearance above the 
Raspberry Pi, and a larger version with a whopping 
45mm to play with. Even with the standard header, 
you can get a low-profile HAT mounted. If you can 
use jumper cables, you can even mount another 
HAT alongside. With the larger enclosure, even the 
larger HATs on the market won’t be constricted. 
Industrial applications have also been 
considered. A ‘stealth’ mode allows Raspberry Pi 
to be mounted fully inside, giving no easy access 
to the ports. And if wall or arm mounting would 
make for a cool touchscreen controller, the rear of 
the case features VESA mounting and eyelets for 
hanging from screws. If you want a custom base, 
additional hinges are provided that can be screwed 
on to your mount of choice. 


We were impressed by the build quality, especially 


at the very reasonable price point. This SmartiPi 
Touch Pro has been carefully thought through and 


customer feedback considered. It’s a solid injection- 
moulded construction riddled with cut-outs so you 
can customise to your heart’s content. Access to the 
microSD card slot would be nice, but it’s blocked 

by the display ribbon cable. Nevertheless, if you’re 
looking for a kiosk or control-centre project, or 
even a highly portable computer (as we featured in 
The MagPi issue #98), the SmartiPi Touch Pro is a 
great bit of kit. 


SmartiPi Touch Pro 


MägPi 


This smart case makes 
a perfect control deck 
or mini workstation 


Smart design means 
lots of space for HATs 
and more 


Verdict 


The sheer range 
of options, 
spacious interior, 
solid design, 
and a great 
price make this 
an essential 
purchase for 
any touchscreen 
project, whether 
it's a control 
centre or 

mini desktop. 
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Asad 3 


SCREEN: 
10.1-inch 
1280x800 

pixel, ten-point 
multitouch 


DIMENSIONS 
/ WEIGHT: 
26x17*4.8 cm; 
2kg 


PORTS: 
Ethernet, HDMI, 
3.5mm audio, 

3 x USB 3.0, 
microSD 


RasPad OS makes 
Raspberry Pi OS touch- 
friendly, adds support 
for the rotating screen, 
and provides an 
on-screen keyboard 


S 


99090000005 


g 
" 


D 
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> Sunfounder > magpi.cc/raspad3 »> £173 / $240 


This chunky tablet promises touchscreen interaction 
with Raspberry Pi. Lucy Hattersley gives it a tap 


with a 10.1-inch, ten-point multitouch 
display. Inside, Raspberry Pi 4 sits between 
two daughterboards. The ‘main board’ breaks 
out the Ethernet, USB C, and audio sockets and 
provides a full-sized HDMI port for a second 
external display and an RCA power socket (a 15V 
2A AC adapter is included as power supply). 
The smaller ‘microSD card and button board’ 
connects to the microSD port on Raspberry 
Pi and enables three buttons (power, plus 
brightness controls). 
Inside the large wedge at the bottom sits a 
three-cell 3Ah lithium battery (we got two-and-a- 
half hours of use). 
One notable absence from the case is GPIO pins. 
However, a small gap in the case enables you to 
feed a ribbon cable to extend the GPIO header. 


at Weng 


R asPad 3 improves upon previous iterations 


We found assembly easy. Use four screws to 
affix Raspberry Pi 4 to the case, then use the USB 
cables, micro HDMI cables, and Type C to connect 
Raspberry Pi 4 to the main board. FFC cables 
are used to connect the smaller daughterboard 
to Raspberry Pi. These are easy to connect, but 
the instructions do not mention how to gently 
pull out the connector and push them back in to 
lock the cable. 


M RasPad 3 is terrific for 
demystifying the technology 
that underpins tablets @ 


Three small heatsinks are attached to the 
Raspberry Pi and a fan, screwed in place to the 
bottom half of the case. Finally, a neat touch. A 
small Accelerometer SHIM Module is placed on top 
of the GPIO pins on Raspberry Pi. When running 
the RasPad OS, this enables a rotating display. Four 
more screws are used to assemble the case. It’s 
important not to leave the microSD card inserted 
when assembling or disassembling the case, as it 
will (and indeed did) break. 


Custom 0S 

RasPad OS (magpi.cc/raspados) is based on 

the latest Raspberry Pi OS but with a refreshed 

interface with larger, touch-friendly buttons, 

additional software support, and tablet-friendly 

features: there’s an on-screen keyboard and 

support for the aforementioned accelerometer. 
One aspect of RasPad 3 that disappoints straight 

out of the box is the built-in fan (which you will 

quickly remove). We’ve never encountered a 


MägPi 


L E et 


Discover the technology 
that sits inside a tablet 
with RasPad 


Raspberry Pi product that makes such a persistent 
noise. It’s a constant buzzing and we found no fan 
throttling controls in software or hardware. 

We found the fan intolerable, to the point where 
we reopened the case and removed it, and dug out 
our heat testing setup to see what performance was 
like without it (magpi.cc/stresstest). We measured 
the idle baseline temperature at 65°C and it ran at 
full stress for several minutes before hitting the 
80°C mark (where Raspberry Pi OS starts to throttle 
back performance). We found little difference 
to using a Raspberry Pi in the official case. As 
usual, we see no reason for a fan to be used with 
Raspberry Pi, unless you plan to overclock. Once 
the fan was stripped out, we were able to appraise 
RasPad 3 with kinder eyes. 

As a tablet, it functions well. The screen is nice 
to look at, and touchscreen performance is snappy 
and responds quickly (if a little haphazardly). 
While functional, the on-screen keyboard is too 
small for our fingers and a chore to type on. Still, 
you can add a Bluetooth or wired keyboard for 


more detailed work. It’s chunky, but you can hold 
RasPad in your hands and rotate it around like a 
commercial tablet. While it’s on a surface, the 
wedge provides two distinct viewing angles. You 
do lose the ability to use the touchscreen when 

a second monitor is attached, but it performs 
admirably as a smaller second display. 

RasPad 3 is terrific for demystifying the 
technology that underpins tablets (key technology 
in many younger learners’ lives). It may be chunky, 
but you can open it up and see the processor, 
screen, battery, and accelerometer in action. It 
may not be as slick as a commercial tablet, but the 
learning process is more rewarding. 

As a daily device, things are less impressive. 

It’s painful to watch RasPad 3 side-by-side 
against pi-top’s FHD Touch Display and Bluetooth 
keyboard (magpi.cc/pitopfhd). The extra money 
spent on the pi-top is well worth it. 

Meanwhile, at the entry end of the scale, devices 
such as SmartiPi Pro offer a touchscreen display 
setup at a much more affordable cost. 


RasPad 3 


Verdict 


It's easy and fun to 
set up RasPad 3, 
but once the 
tablet components 
lesson is over, 

it's not great fun 
to use. Jarring 
elements (in 
particular the 

fan) don't help. 
There are better 
Raspberry Pi 4 
tablet and laptop 
options on 

the market. 
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10 Amazing: 


Raspberry 
P1 Pico 
add-ons 


Upgrades for the newest 
Raspberry Pi family member 


weeks and it’s already got a huge host of 

add-ons specifically made for it! Some of 
these have really inspired us to think up new projects. 
Here are just ten of them. M 


R aspberry Pi Pico has been out for only six 


4 Breadboard Kit 


Prototyping board 


Another way of learning is by having components connected 
straight to the same breadboard as Pico itself. The breadboard 
here is sizeable and the built-in buttons and LEDs are a 

nice addition. 


£14/ $20 | magpi.cc/picobread 


a RGB Keypad Base 


Customisable keypad 


We like the keypad range Pimoroni does, and we're already thinking up ways to 
create our own macro keypad with one of these and a Pico. Look out for that in 
a future issue. 


£22 / $25 | magpi.cc/rgbkeypad 


> Get Started with — 
MicroPython on Micro Py Sco 
Raspberry Pi Pico 


ve l 
0 


Book of knowledge 


The ultimate accessory for Pico is the Get Started with 
MicroPython book, which has a breakdown of what Pico 


can do, and how you can make use of its various abilities. 
£10 / $14 (or free PDF) | magpi.cc/picobook B 


á me Lal BREAKOUT 1 BREAKOUT 2 
“pico lors 


10:10 21 Jan 21 
© Weed 15-24) 
6 55% EIN 
Q 34t 1,015 GM 
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s3 
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lp 
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a Explorer Base 


Electronics with Pico 


These types of breadboard breakout boards always rate highly with us as 
simple and easy ways to get to grips with how tech works. While others work 
well with a Raspberry Pi, this one is perfect for Pico. 


£22 / $26 | magpi.cc/explorerbase 
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a HAT Expansion 


Add HATs 


Fancy using a Raspberry Pi HAT with a Pico? SB Components has you covered 
with this special add-on. It also keeps the pins on Pico available to use. 


£10/ $15 | magpi.cc/picohat 


> Female headers 


Opposite header style 


If you want pins that you can plug 
jumper wires into, or any other kind 
of wire, these female headers will be 
right up your alley. 


£1/S2 | magpi.cc/femheader 


a GPIO Expansion Board 


Solderless pin access 


If you don't fancy soldering headers to your Pico, this board allows you to make 
use of both male and female headers for whatever project you're working on. 
It's great for prototyping. 


£8/ $11 | magpi.cc/picogpio 
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lent few 
pimoronl.com/picoaudto 


4 Audio Pack 


Portable stereo sound 


Turn Pico into a simple sound card / amplifier for a Raspberry Pi, 
or other hardware if you know how to tweak it. It wouldn't be too 
hard to turn this into part of a mini MP3 player as well, in case you 
miss those. 


£14/ $16 | magpi.cc/audiopack 


> Display Pack 


Tiny and colourful 


This is a 1.14-inch, RGB, IPS LED display, 
which is ridiculous! Pico can power it 
fairly easily, and the display itself has 
some physical buttons on it. You could 
easily use it for simple games or 
costume wearables. 


£14/ $16 | magpi.cc/displaypack 


a Header Pack 


Male headers 


While not essential, soldering on headers to a Raspberry Pi Pico 
makes it easy to add it to a breadboard or use jumper wires to 
attach to other circuit bits. Time to practise your soldering skills. 


£2 /$2 | magpi.cc/headerpack 
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Learn game development 
with Raspberry P1 


Get a head start with Raspberry Pi game creation with this resource list. By Mark Vanstone 


Hitch.io 


For most developers of games, 


es Itch corp the main reason to create a 

B game is to challenge others to 

Pr Price: play their game. So the first 

c Free / Percentage question is: how can we make a 
otsale game available for other people 
itch.io 


to play? That’s where itch.io 
comes in. The website provides 
an app store-style platform for 
independent developers to 
upload and sell their games. 
Games can be built and 
uploaded in all kinds of formats. 
They can be built as executables, 
source code downloads, or online 
browser games. There is a large 
active community, and regular 
competitions to reward the best 
games. The itch.io site is free to 
use and provides lots of support 


M itchio BrowseGames Gametams & UplosdGame Deviogs Community . Login Register 


POPULAR TAGS 


BROWSE 


SB BW dooce 
a “Boe 


for new developers and if you 
want to sell your game, they will 
deal with all the payment 
process but, of course, ask fora 
small cut of the profits. 
Currently there are over 
300,000 games hosted on itch.io, 


Latest Featured Games v=»! 


Tech lo is a simple way to find and share incte games orline for free. 


sotali and manege you! 


Cloud Climber 


A lignihearted walking sin about the end of hurar: 


i: 


n ea: 


Promaster. M za Hes Panon 


EM sso 


so you can have a good look 
around and see what everyone 
else has uploaded, and get ideas 
about how to present your new 
game to the world, get feedback 
from players, and even make a 
bit of money. 


Books for game development 


Paper-based or online books for reference and tutorial 


ADVENTURES IN MINECRAFT 
A treasure-trove of a book, both 
paper-based and for download. 
Learn to build games using 

the Minecraft engine, and even 
program external controllers to 
trigger events in-game. 
magpi.cc/advminecraft 
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CODE THE CLASSICS 

Learn how to create your own 
versions of retro games from 
scratch using Python and Pygame 
Zero. Five classic video games 
are remade, ranging from Pong to 
Sensible Soccer. 
magpi.cc/codetheclassics 


MAKE GAMES WITH PYTHON 
An in-depth look at game creation 
with Python and Pygame. From your 
first game to physics simulations 
and alien invaders, this book is 
packed full of useful techniques 
and listings. 
magpi.cc/makegamespython 
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f Scratch 


Game 


5 Scratch ; Scratch is available as a game Raspberry Pi’s website for you to 

> Foundation and animation development see what others have done with C re at re) Y 
= Price: system, both in a browser and Scratch. Graphics and sounds are 

SF Free as an offline program. Both included in the Scratch library, 


Resources 


scratch.mit.edu 


work and look very similar. 
Scratch is an excellent 
introduction to programming, 
and provides a visual block 
interface to create interactive 
content. You can share games 
that are created with Scratch, 
and there are lots of examples on 


Mare a Chase Game 


but you can also create your own 
using the built-in pixel editor or 
a separate paint package. There 
are extra extensions you can add 
to connect to external projects, 
and a whole range of tutorials to 
show you how to get started 
making the game of your choice. 


Avimate A Character Make a Cicher Game 


f Raspberry Pi Game Projects 


Raspberry Pi 
Foundation 


CREATOR 


Price: 
From £19.99 


magpi.cc/ projects 


B | tome 


Against the Clock 


Make a timer and use it to 


na enge you trance 


Since the launch of Raspberry 
Pi, the Raspberry Pi Foundation 
has been producing example 
projects of all kinds on its 
website. In the game section, 
there are around 60 projects 


Signin 


SSB fa ll 


for you to delve into and find 
out how they were made and 
download the elements you 
need to build them. There are 
projects for Scratch, Python, 
web browsers, and even games 
to play with external hardware, 
ike the Sense HAT. Each project 
describes what you will need 

to make it, shows the finished 
project, and then walks you 
through, step by step, what 

you need to do from beginning 
to end. You will also find 
suggestions for other projects to 
look at after you have finished, to 
progress further with your game 
development experience. M 


Get free game 
resources online 


PI GAME DEV 


Pi Game Dev is a well- 


organised site dedicated 
solely to resources for making 
games on Raspberry Pi. There 
are comprehensive lists and 
links to game engines, art and 
music tools, code editors, and 
game assets. 

pigame.dev 


OPENGAMEART.ORG 
OpenGameArt is a go-to, 
one-stop, free shop for 2D 
and 3D game graphics and 
sound effects. Searchable and 
categorised, this site features 
thousands of submissions from 
designers. You can submit 
your own creations to give 
something back. 
opengameart.org 


SPRITERS RESOURCE 
Sprite sheets are bitmaps 
full of animation frames, and 
Spriters Resource has all the 
retro game graphics in sprite 
sheet format. Just search 

for your favourite game and 
there's likely to be a sprite 
sheet or two for it. 
spriters-resource.com 
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MéigPi 


Name 
Community role 


f you’re part of the online 

Raspberry Pi community, 

it’s hard to miss posts from 
Tanya Fish, aka tanurai. She 
creates cool things and has great 
insights into making. 

“I used to program the BBC 

Micro using BASIC code from 


Tanya continued the 
tradition of making earrings 
resembling new, tiny 
Raspberry Pi boards - this 
one is a handmade Pico 


—_— 


magpi.cc Tanya Fish 


Tanya is all over the online Raspberry Pi community. 
How did this engineer, teacher, and student start out? 


Occupation 


url 


the back of magazines as a kid, 
and got in trouble at school 

for altering Granny’s Garden 
(an educational puzzle-solving 
game),” Tanya tells us. “When 

I was 16, my dad put a Ford 
Sierra in front of me and said 
‘take that apart’. I’d been taking 


things apart throughout my 
childhood, and I think that 

was the first thing that was 
physically useful. I was lucky 
enough to work with a drag 
racing team for a few years on 

a Fuel Altered [car] that did the 
quarter mile in 7.4 seconds. I 
carried on making anything | 
could - woodworking, drawing, 
knitting, crochet, smaller things 
mainly. Then I discovered 
Raspberry Pi and got into 
learning my way around a Linux 
operating system, and started to 
teach myself Python.” 

After working for our cool, 
gadget-making pals Pimoroni, 
Tanya is back at school working 
towards a PhD “in the effects of 
STEM outreach in schools”. 


When did you learn about 
Raspberry Pi? 

Probably in the later half of 2012, 
and a lot of my friends were 
using them as media servers. I 
got one for Christmas 2012 - and 
I still have it! Pve used every 
model since, and I liked it that 
they were small enough to build 
into projects. 


A Tanya has also presented at Maker Faire 


What is your favourite way to 
interact with the community? 
My favourite way to get 
involved in the community is 
by volunteering at events like 
Raspberry Jams, sometimes 
giving talks, workshops, or 

just bringing along a project 

to talk about. Luckily, my 
previous employers were 

really supportive of that, and I 
loved standing at the stall and 
chatting with people about 
what they were making, and 
helping out with equipment 
choices. I try to write up personal 
projects, but documentation 

is time-consuming! 


What has your experience been 
like with Raspberry Pi? 

I think there’s a lot more to 
come from Raspberry Pi. I have 


m | think there's 
a lot more to 
come from 
Raspberry Pi @ 


never been a computing teacher, 
yet I have used a Raspberry Pi 
and coding for every subject ve 
taught. There’s a lot to be said 
for their creative use - last year 
one of my graphics students 
made an interactive video player 
controlled by children’s toys to 
teach history - and to say that 
they can go from not knowing 
any code to that shows the ease 
of use of Raspberry Pi. I look 
forward to using them in my 
teaching for years to come. M 
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Big projects 


Eurovision crown 


“I think that the first big project | did was with a 
Raspberry Pi Zero W, for a Eurovision party in 
2017. It used APA102 pixels and a Scroll pHAT, 
and ran off a Poundland battery pack. | was just 
starting out with Python then, but | managed 
to make it grab tweets about Eurovision and 
scroll them across the front of the crown.” 


Giant Picade 


“A project | built a workshop around was a 
giant breakout of the controls to play games 
using RetroPie on a Raspberry Pi 3B+. | got kids 
to build all of the switches using cardboard 
and foil, and clip them onto this rig. We were 
playing Mario with a spoon, flip-flops, head- 
desks, and homemade tilt switches.” 


Elephant nightlight 


“Į also did a kids’ nightlight using a Raspberry 
Pi Zero, which changes colour depending on 
whether it's time to get up or go to sleep. | 
liked that Raspberry Pi Zero is small enough 
to fit inside a 1 pint milk bottle! It's actually a 
useful project; most of the things | build are 
frivolities — | like playing with tech creatively.” 
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This Month in 
Raspberry P1 


MagP1 Monday ` 


Amazing projects direct from our Twitter! 2 poner ap 
very Monday we ask the question: have you Reptying to OThehagPi 
made something with a Raspberry Pi over More work on my #piwars robot #MacFeeglePrime! Just 
the weekend? Every Monday, our followers got both cameras working and sending video to my 

send us amazing photos and videos of the things custom controller :) 

they’ve made. 

Here’s a selection of some of the awesome things Running on a @StereoPi board, slowly coming 
we got sent this month - and remember to follow together! 


along at the hashtag #MagPiMonday!! Ml 


01. MacFeegle Prime is the mini Johnny 5 of 
our dreams 


02. We had a couple of people show us time- 
lapses over the last month, and they're 
all great 


03. Bread rising is a miracle of food science 


MB76978199 


mB 
04, As you may imagine, it does not work well & i 


@TheMaghi 


05. While this may look like Asteroids, it's just a sinebaran eset 
very pretty display 
06. We love seeing this project evolve! 


07. An amazing build here, worthy of the 
space station 


08. This robot clearly means business 


09. This Star Trek TNG tricorder looks 
extremely legit 


10. Snow is very cool. It's fun to watch it build 
up like this 
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8 Bits and a Byte 
@8BitsandaByte 
maxi14x r 


ana Replying to @TheMagPi 
Repay toe near We built an Al Label Maker to make home organisation 
Just watching bread rise more efficient! £ 


Spoiler alert: it works about as well as you imagine 


Dr Footleg - Roboteer 
@driootleg 


Replying to @TheMagPi 


| ran 73,728 LEDs at once off a Raspberry Pi 4, testing Replying to @TheNags 
my new Pi power PCB design. This iteration could #MagPiMonday Writing scripts to generate microtonal 
handle 4A continuous load without overheating. melodies on my monome norns shield / raspberry pi 
3b+ 
@ or Footieg - Roboteer @drfooties - Jan 31 @ Rob erdelinestor -Jan 3 ER 
Let's go LED crazy! *jamuary #microtonal meenharmonic #ElectronicMusic #moneme #noms ow tomin 
#retaceCP #arn 2021 SDe’ Qo-6 


Hopefully the Final stretch for getting my sons 
spaceship cockpit done! 


Watch again 


directiveO 
@directived 


Replying to @TheMagPi 


11:17 AM + Feb 1, 2021 - Twitter Web App 


® Laurence Molloy 
@MolloyLaurence 
kd 


Replying to @TheMagPi 


I'm making a Raspberry Pi based Tricorder. 


| spent this weekend helping my eldest son (15) polish 
off his Arkwright Engineering Scholarship application - 
his reference project is his involvement in a PiWars 

team this year, solving the Tidy Up The Toys challenge. 


Here are some photos of his early robot attachment 
designs. 


Replying to @TheMagPi 

| did a time lapse of a snow storm we just had using Pi 

1 - Twitter Web App Zero attached to a USB webcam. Added some music 
and even put it on YouTube. ij 


© 


n 


6:38 PM - Jan 25, 2 


Snow Time Lapse Richmond Va January 2021 (fast) 
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Mondays are for Pico 


#MagPiMondays aren't just for standard Raspberry Pi projects 


as Kevin McAleer 
ass = | 
aspberry Pi Pico was released two days 3 to © thedtag? 
after we went to press last issue, so we Adding a Pico to my opencat! 


weren’t able to feature any community 
projects then. 
This month, though, we have plenty. Take a peep 
at some Pico projects that were shared with us on 
#MagPiMonday. Hl 


MA tanya Fish 
oz F seu 
Replying to @TheMagP 
Replying to @TheMagP M- Je sitter for et 


Generating tones from the PIO state machine toggling Putting coloured headers on pico number 2. Yes, | 
a pin:- realise a few of my choices are unconventional 


Q Anne Carli 
m vine, On th ` uaa 
ves any one know h Thoha 
? @Raspberry.Pi , 


One large step for me but a small step for 
*RaspberryPiPico . Got the LED to light up on the Pico 
#MagPiMonday 


Caroting Dunn 


I worked on a #raspberrypi Pico Hydrometer with LCD 
screen for @tomshardware #raspberrypipico in C/C++ 
using the Pico-SDK 


A Brian Corteli © 
01. Would a Pico Cat be a Picat? : ian 


02. The MagPi regular Mike Cook has a go with My Tom, who is 11 soldered up his Raspberry Pi Pico* 


music on Pico using PIO then flashed, dimmed LEDs, controlled them with a 
button and a pot. 
03. Avery important thing to learn! Other news: I just made my Pico flash a LED and started 
programming a web interface to control a 
04. Colour-coding pins is a great way to make #MicroPiNoon robot £ 
prototyping a little quicker “Very pro job on the soldering! 


05. We could not solder that well at eleven 
years old 


06. As usual, Caroline is getting stuck in doing 
cool stuff with Pico 
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Other amazing things from the community 


RASPBERRY PI 4 DJ SETUP | DRIVING OBJECT DETECTION 


This setup looks amazing, and Reddit user Error_No_Entity has This is an incredible build using Raspberry Pi 4, TensorFlow, and publicly 
included an OS image so you too can have this excellent build. We'd available training datasets. It’s amazing what you can do with computer 
love to know more about the physical build, though. vision on a Raspberry Pi. 
magpi.cc/djpi4 magpi.cc/rpiroad 
RETRO_MATRIX ANOTHER AIRPORT RASPBERRY PI | PLOTTYBOT 


Uses (s; Soroen, 
usag 2), S020: 


` root ma 
2902) oozes” 
utaa reer aai2ea 


Reddit user Gorse212 has been customising “My local rinky-dink airport apparently runs 

retro games to work on a large LED matrix, the arrivals tracking on a [Raspberry Pi 4," This ingenious build perfectly copies not only 

and they look pretty cool! This could easily points out Voxxom on Reddit. It seems like your handwriting, but will also write out text 

be scaled up to larger projects as well, more and more airports are using them. that you've typed. Now handwritten notes 

we think. Hopefully they'll fix this one. don't have to be... handwritten. 
magpi.cc/retromatrix magpi.cc/pi4airport magpi.cc/plottybot 


Best of the rest! magpi.cc g1 
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Your 
Letters 


RP2040 minus Pico 


Will the RP2040 be available to buy as an IC from usual 
suppliers? I really want to use it as the base IC for a 
new sensor board, but the footprint of the Pico module 
is too big. 


Jah via email 


According to our friends at HackSpace magazine: “It will 
be once there’s enough of them created. We’re expecting 
Q2 this year, but this isn’t confirmed yet.” 

For those not in the know, you can buy and use 
RP2040, the core chip that powers Raspberry Pi Pico. A 
few microcontroller makers are already coming out with i rae dieo 
their own ranges of boards with RP2040 chips, and the your Pico is up to you 
sky’s the limit. 


Pre-soldered Pico 


Is there any way to get a Raspberry Pi Pico that has the pins 
already soldered onto it? My soldering skills aren’t quite up to 
scratch, I’m afraid. 


Charlotte via Facebook 


You can actually get pre-soldered Pico boards from many of the Pico 
resellers, such as SB Components and Pimoroni. They’re usually in 
more limited supply, though, and will cost a bit extra. 

We personally like the holes, as for some wearable stuff it’s a 
bit more useful. Also, it would be good practice to solder on the 
headers anyway! 


A It's not out just yet, but 
Adafruit is working on a new 
Feather board with RP2040 
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V This DAC is also a HAT, which 
we understand makes things 
even more confusing 


Any chance of an up-front glossary on your website for complete 
novices like me? There are so many acronyms - HAT, pHAT, 
DAC, etc. — that I get completely lost in having to look them up 
elsewhere. And even then, they are not always well explained 
because they assume another level of knowledge. 

Perhaps there is one, but I couldn't find it! 


Nick via email 


You’re correct, we don’t currently have a glossary of terms like this. 
However, it’s a good idea, and we’ll try and get one set up. We’ll put 
it on GitHub so folks can make suggestions for it - otherwise, any 
acronyms or terms you think of, don’t hesitate to let us know so we 
can add them! 
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Coolest Projects 


When does Coolest Projects registration open? Is it 
separated by locale like in previous competitions? I’d 
really like something to work towards right now! 


Dale via twitter 


You're in luck, as registration has recently opened! You 
can register here: magpi.cc/cpregister. 

This year the competition is worldwide, and everyone 
up to the age of 18 can participate! There are loads of 
categories you can apply for, and there are workshops and 
tips on how to manage your project. You have until 3 May 
to apply, so get online and get started! 


2020 SHOWCASE GALLERY 


Al Trash Can 
theatre ] 
ee eae 


A Submit your project to be in 
the online showcase gallery! 


Contact us! 


> Twitter @TheMagPi 


> Facebook magpi.cc/facebook 


> Email 
> Online 


magpi@raspberrypi.com 
raspberrypi.org/forums 
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HackSpace 


TECHNOLOGY IN YOUR HANDS 
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i 
RFID HATS! 


The RFID HAT for Raspberry Pi allows you 
make use of RFID tags that you already have, or 
the programmable card or fob that comes with 
it. It even has a little LCD screen. We gave it an 
8/10 last issue, and now ten are up for grabs. 


Components 


We Make Things Intelligent 


Learn more: magpi.cc/rfidhat | Head here to enter: magpi.cc/win 


Terms & Conditions 


Competition opens on 24 February 2021 and closes on 25 March 2021. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi Foundation, 
the prize supplier, their families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any 
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants’ details 
will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram or Facebook. 
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Wirefra 


LIFTING THELID ON envio ZN 


Wire GRAFTED 
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WAR GAMES 


How military thinking 
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Vertical innovation 


James Adams on building Raspberry Pi’s first microcontroller platform 


n 21 January we launched 
0 the $4 Raspberry Pi Pico. As I 

write, we’ve taken orders for 
nearly a million units, and are working 
hard to ramp production of both the 
Pico board itself and the chip that 
powers it, Raspberry Pi RP2040. 

Microcontrollers are a huge yet 

largely unseen part of our modern 
lives. They are the hidden computers 
running most home appliances, 
gadgets, and toys. Pico and RP2040 
were born of our desire to do for 
microcontrollers what we had 
done for computing with the larger 


well as requiring specialist skills, you 
need a lot of expensive tools and IP. 
After a slow start, for the past couple 
of years we’ve had a small team 
working on it full-time, with many 
others pulled in to help as needed. 


Low-cost and flexible 

The Pico board was designed 
alongside RP2040 - in fact we 
designed the RP2040 pinout to work 
well on Pico, so we could use an 
inexpensive two-layer PCB, without 
compromising on the layout. A lot of 
thought has gone into making it as 


m This ‘full stack design approach has allowed 
optimisation across the different parts Ø 


Raspberry Pi boards. We wanted to 
create an innovative yet radically low- 
cost platform that was easy to use, 
powerful, yet flexible. 

It became obvious that to stand out 
from the crowd of existing products 
in this space and to hit our cost and 
performance goals, we would need to 
build our own chip. I and many of the 
Raspberry Pi engineering team have 
been involved in chip design in past 
lives, yet it took a long time to builda 
functional chip team from scratch. As 
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low-cost and flexible as possible — 
from the power circuitry to packaging 
the units on to tape and reel (cost- 
effective with good packing density). 
With Pico we’ve hit the ‘pocket 
money’ price point, yet in RP2040 
we’ve managed to pack in enough 
CPU performance and RAM to run 
more heavyweight applications such 
as MicroPython, and AI workloads like 
TinyML. We’ve also added genuinely 
new and innovative features such as 
the Programmable I/O (PIO), which 


can be programmed to ‘bit-bang’ 
almost any digital interface without 
using valuable CPU cycles. Finally, we 
have released a polished C/C++ SDK, 
comprehensive documentation and 
some very cool demos. 

For me, this project has been 
particularly special as I began my 
career at a small chip-design startup. 
This was a chance to start from a clean 
sheet and design silicon the way we 
wanted to, and to talk about how and 
why we’ve done it, and how it works. 

Pico is also our most vertically 
integrated product; meaning we 
control everything from the chip 
through to finished boards. This ‘full 
stack’ design approach has allowed 
optimisation across the different 
parts, creating a more cost-effective 
and coherent whole. 

And of course, it is designed here in 
Cambridge, birthplace of so many chip 
companies and computing pioneers. 
We're very pleased to be continuing 
the Silicon Fen tradition. Hl 


James Adams 


As Raspberry Pi Trading’s Chief Operating 
Officer and Hardware Lead, James has 
been deeply involved in Raspberry Pi 
product development since 2013. 


@JamesAdams314 
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Partner and official reseller for top Pi brands: 


| . eG. tees and many 
Keadafruit sparkfun. »IMORONI 6p HiFiBerr: athere] 


qs BuyaPi.ca 8 


Robotics & rapid prototyping 
with your Raspberry Pi 


Power your projects with computer vision and applied AI 


pi-top [4] Robotics Kit comes with electronic components such as a wide-angle 
camera, servos and motors, all of which plug and play with the pi-top [4] 
Complete or pi-top [4] DIY Edition’. 


pi-top Robotics Kit with Expansion Plate 


187.90 / $199.90 
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pi-top.com/MagPi 


Raspberry Pi is a trademark of the Raspberry Pi Foundation. ‘pi-top [4] and Robotics Kit with Expansion Plate sold separately. © CEED Ltd. 2021 


Raspberry Pi made simple, robust and modular. 


